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


Swift KeyValuePairs 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 > 0limit 应该大于 i 才能产生任何影响。同样,如果 distance < 0limit 应该小于 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+

相关用法


注:本文由纯净天空筛选整理自apple.com大神的英文原创作品 KeyValuePairs index(_:offsetBy:limitedBy:)。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。