← All notes

Short answer

You use optionals in situations where a value may be absent [S1]. Write an optional type with a question mark after the type name, as in Int? [S1]. Optional is an enumeration with two cases, .none and .some [S2]. Optional binding extracts a value; force unwrapping a nil value triggers a runtime error [S1].

let possibleNumber = "42"
if let number = Int(possibleNumber) {
    print("Value: \(number)")
} else {
    print("Not a number")
}

Key points

• An optional variable without a default value is automatically set to nil. [S1]
• Optional binding with if, guard, or while extracts a value into a constant or variable. [S1]
• You can provide a fallback value using the ?? operator. [S1]
• Force unwrapping a nil value triggers a runtime error. ! is a shorter spelling of fatalError. [S1]
• Int? is another way of writing Optional<Int>. Optional.none is equivalent to the nil literal. [S2]
• An implicitly unwrapped optional, written String!, is a normal optional behind the scenes but can be used like a non-optional value. [S1]

Pitfalls

• If you try to assign nil to a non-optional value, you get a compile-time error. [S1]
• Don't use an implicitly unwrapped optional if the variable might become nil later. [S1]
• The unsafelyUnwrapped property trades safety for performance. In optimized builds, no check is performed. [S2]

Claims

• id: C1 claim: An optional can hold a value of a type or no value at all. source: S1 evidence: "in situations where a value may be absent"
• id: C2 claim: An optional type is written with a question mark after the type name. source: S1 evidence: "you write a question mark"
• id: C3 claim: Force unwrapping nil stops execution with a runtime error. source: S1 evidence: "Force unwrapping a nil value triggers a runtime error."
• id: C4 claim: An optional variable with no default value is set to nil automatically. source: S1 evidence: "the variable is automatically set to nil"
• id: C5 claim: Optional is an enumeration with none and some cases. source: S2 evidence: "The Optional type is an enumeration with two cases."
• id: C6 claim: The unsafelyUnwrapped property trades safety for performance. source: S2 evidence: "This property trades safety for performance."

Sources

• [S1] The Basics - The Swift Programming Language. https://docs.swift.org/swift-book/documentation/the-swift-programming-language/thebasics/ . License: Apache-2.0. Accessed 2026-11-11.
• [S2] Optional.swift - Swift standard library. https://github.com/swiftlang/swift/blob/main/stdlib/public/core/Optional.swift . License: Apache-2.0 with Runtime Library Exception. Accessed 2026-11-11.

License: this note is CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Summary by iinventedlight (AI-assisted). Sources and notices: The Swift Programming Language (swiftlang/swift-book): Copyright (c) 2014-2026 Apple Inc. and the Swift project authors; Apache-2.0 (https://raw.githubusercontent.com/swiftlang/swift-book/main/LICENSE.txt). Swift standard library (swiftlang/swift): Copyright (c) 2014-2026 Apple Inc. and the Swift project authors; Apache-2.0 with Runtime Library Exception (https://raw.githubusercontent.com/swiftlang/swift/main/LICENSE.txt). Text was condensed and changed from the originals.

@misc{iil_note_3yzgzex7,
  author = {{iinventedlight}},
  title = {{Swift optionals, nil, binding, and force unwrapping}},
  howpublished = {iinventedlight Library},
  year = {2026},
  date = {2026-11-11},
  url = {https://iinventedlight.com/library/notes/swift-optionals/},
  note = {Permanent ID iil:note:3yzgzex7. License: CC-BY-4.0.},
}

Markdown

Spotted a mistake? Use the MCP feedback tool or email hello@iinventedlight.com.

For language models and agents: start at /llms.txt | /agents.md | /.well-known/agent-library.json. This page in Markdown: /library/notes/swift-optionals.md.