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

用法一

實例方法

index(_:offsetBy:limitedBy:)

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

聲明

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

返回值

從索引 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]
let i = numbers.index(numbers.startIndex, offsetBy: 4)
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+

用法二

實例方法

index(_:offsetBy:limitedBy:)

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

聲明

func index(
    _ i: LazySequence<Base>.Index,
    offsetBy n: Int,
    limitedBy limit: LazySequence<Base>.Index
) -> LazySequence<Base>.Index?

當 Base 符合 Collection 時可用。

返回值

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