Skip to content

Latest commit

 

History

History
72 lines (44 loc) · 1.67 KB

nnnn-bool-toggle.md

File metadata and controls

72 lines (44 loc) · 1.67 KB
Raw

Feature name

During the review process, add the following fields as needed:

Introduction

I propose adding a mutating func toggle to Bool. It toggles the Bool.

Swift-evolution thread: Discussion thread topic for that proposal

Motivation

For Bool variables, it is common to want to toggle the state of the variable. In larger (nested) structs, the duplication involved can become especially annoying:

myVar.prop1.prop2.enabled = !myVar.prop1.prop2.enabled

It's also easy to make a mistake in the code above if there are multiple Bool vars.

Proposed solution

Add a method toggle on Bool:

extension Bool {
    mutating func toggle() {
        self = !self
    }
}

This allows us to write the example above without duplication:

myVar.prop1.prop2.enabled.toggle()

Detailed design

N/A

Source compatibility

This is strictly additive.

Effect on ABI stability

N/A

Effect on API resilience

N/A

Alternatives considered

Other names could be:

  • invert
  • negate
  • flip

From the brief discussion on SE, it seems like toggle is the clear winner.

Some people also suggested adding a non-mutating variant (in other words, a method with the same semantics as the prefix ! operator), but that's out of scope for this proposal.