Swift AnyBidirectionalCollection index(_:offsetBy:limitedBy:)用法及代码示例

实例方法

index(_:offsetBy:limitedBy:)

返回与给定索引的指定距离的索引，除非该距离超出给定的限制索引。

声明

func index(
    _ i: AnyBidirectionalCollection<Element>.Index,
    offsetBy n: Int,
    limitedBy limit: AnyBidirectionalCollection<Element>.Index
) -> AnyBidirectionalCollection<Element>.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大神的英文原创作品 AnyBidirectionalCollection index(_:offsetBy:limitedBy:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。