String.Index

⭐️ 注意：

使用 str[index] 時，有一個「隱藏的雷區」：雖然 endIndex 是一個 valid String.Index 但如果使用 str[str.endIndex] 馬上會造成 crash❗️尤其是使用：

str.index(_:offsetBy:limitedBy:)

的時候要小心，不要像官網這樣寫：

// offset: 01234
let s  =  "Swift"
//           ╭─────────── ⭐️ offset = 5 會得到 endIndex❗️ ───────────╮
if let i = s.index(s.startIndex, offsetBy: 5, limitedBy: s.endIndex) {
    print(s[i])    // 💥 這裡就會進入「雷區」
}

💈範例

let str = "apple,pear,peach,orange,cherry,lime,goosberry"

// ⭐️ String.Index
let i = str.index(str.startIndex, offsetBy: 2)    
let j = str.index(str.startIndex, offsetBy: 10)
// ⭐️ 注意：
//    在這裡，只要 offset 超出合理範圍，就會產生下列錯誤：
//    「⛔ Fatal error: String index is out of bounds」
//    直接造成 crash，不需等到放到 subscript 中 (如：`str[i]`)。

// ⭐️ 就算使用 str.index(_:offsetBy:limitedBy:) 的版本，
//    如果「擋錯邊」，一樣會 crash❗️例如：
let index = str.index(
    str.startIndex, 
    offsetBy: -2, 
    limitedBy: str.endIndex    // ⭐️ 擋錯邊❗️
)

str[i]        // ⭐️ Character: "p"
str[i..<j]    // ⭐️ Substring: "ple,pear"

📘 手冊

• Swift ⟩

  • String ⟩

    • .index(_:offsetBy:)

    • .index(_:offsetBy:limitedBy:)

    • String.Index (struct)

    • .endIndex

  • Collections ⟩

    • Range<Bound> - (generic struct)

🔸 定義

// str.index(_:offsetBy:)
func index(
    _        i: String.Index, 
    offsetBy n: String.IndexDistance    // ⭐️ = Int
) -> String.Index

// str.index(_:offsetBy:limitedBy:)
func index(
    _        i: String.Index, 
    offsetBy n: String.IndexDistance, 
    limitedBy limit: String.Index
) -> String.Index?

🗣 討論

• How does String.Index work in Swift?

👥 相關

• str[i], str[i..<j], str[i...j]

• reachability