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:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。