实例方法
index(_:
index(_:offsetBy:limitedBy:)
返回与给定索引的指定距离的索引,除非该距离超出给定的限制索引。
声明
func index(
_ i: Self.Index,
offsetBy distance: Int,
limitedBy limit: Self.Index
) -> Self.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+
相关用法
- Swift Dictionary index(_:offsetBy:)用法及代码示例
- Swift Dictionary index(forKey:)用法及代码示例
- Swift Dictionary indices用法及代码示例
- Swift Dictionary init(uniqueKeysWithValues:)用法及代码示例
- Swift Dictionary init(grouping:by:)用法及代码示例
- Swift Dictionary init(dictionaryLiteral:)用法及代码示例
- Swift Dictionary init(_:uniquingKeysWith:)用法及代码示例
- Swift Dictionary isEmpty用法及代码示例
- Swift Dictionary allSatisfy(_:)用法及代码示例
- Swift Dictionary values用法及代码示例
- Swift Dictionary dropFirst(_:)用法及代码示例
- Swift Dictionary firstIndex(where:)用法及代码示例
- Swift Dictionary first(where:)用法及代码示例
- Swift Dictionary merge(_:uniquingKeysWith:)用法及代码示例
- Swift Dictionary subscript(_:default:)用法及代码示例
- Swift Dictionary reduce(_:_:)用法及代码示例
- Swift Dictionary suffix(from:)用法及代码示例
- Swift Dictionary subscript(_:)用法及代码示例
- Swift Dictionary makeIterator()用法及代码示例
- Swift Dictionary randomElement()用法及代码示例
- Swift Dictionary dropLast(_:)用法及代码示例
- Swift Dictionary min(by:)用法及代码示例
- Swift Dictionary max(by:)用法及代码示例
- Swift Dictionary updateValue(_:forKey:)用法及代码示例
- Swift Dictionary removeValue(forKey:)用法及代码示例
注:本文由纯净天空筛选整理自apple.com大神的英文原创作品 Dictionary index(_:offsetBy:limitedBy:)。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。