当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


Swift Dictionary 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

偏移距离 idistance 不能为负数,除非集合符合 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大神的英文原创作品 Dictionary index(_:offsetBy:limitedBy:)。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。