Swift RandomAccessCollection index(_:offsetBy:limitedBy:)用法及代碼示例

實例方法

返回與給定索引的指定距離的索引，除非該距離超出給定的限製索引。

必需的。提供默認實現。

func index(
    _ i: Self.Index,
    offsetBy distance: Int,
    limitedBy limit: Self.Index
) -> Self.Index?

從索引 i 偏移 distance 的索引，除非該索引在移動方向上超出 limit。在這種情況下，該方法返回 nil 。

i: 集合的有效索引。
distance: 偏移距離 i 。 distance 不能為負數，除非集合符合 BidirectionalCollection 協議。
limit: 用作限製的集合的有效索引。如果 distance > 0 ，小於 i 的限製無效。同樣，如果 distance < 0 ，則大於 i 的限製無效。

下麵的示例從字符串的起始索引獲取前四位的索引，然後在該位置打印字符。該操作不需要超出限製 s.endIndex 值，因此它成功。


let s = "Swift"
if let i = s.index(s.startIndex, offsetBy: 4, limitedBy: s.endIndex) {
    print(s[i])
}
// Prints "t"

下一個示例嘗試從 s.startIndex 檢索索引六個位置但失敗，因為該距離超出了作為 limit 傳遞的索引。


let j = s.index(s.startIndex, offsetBy: 6, limitedBy: s.endIndex)
print(j)
// Prints "nil"

作為distance 傳遞的值不得將i 偏移超出集合的邊界，除非作為limit 傳遞的索引防止偏移超出這些邊界。

iOS 8.0+, iPadOS 8.0+, macOS 10.10+, Mac Catalyst 13.0+, tvOS 9.0+, watchOS 2.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 RandomAccessCollection index(_:offsetBy:limitedBy:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。