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

實例方法

index(_:offsetBy:limitedBy:)

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

聲明

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

返回值

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

參數

i: 數組的有效索引。
distance: 偏移距離 i 。
limit: 用作限製的集合的有效索引。如果 distance > 0 ，如果 limit 小於 i 則無效。同樣，如果 distance < 0 ，如果 limit 大於 i 則無效。

詳述

下麵的示例從數組的起始索引獲取前四個位置的索引，然後打印該位置的元素。該操作不需要超出限製 numbers.endIndex 值，因此它成功。


let numbers = [10, 20, 30, 40, 50]
if let i = numbers.index(numbers.startIndex,
                         offsetBy: 4,
                         limitedBy: numbers.endIndex) {
    print(numbers[i])
}
// Prints "50"

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


let j = numbers.index(numbers.startIndex,
                      offsetBy: 10,
                      limitedBy: numbers.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大神的英文原創作品 ContiguousArray index(_:offsetBy:limitedBy:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。