Instance Method インスタンスメソッド

distance(from:to:)

Returns the distance between two indices. ２つのインデックス間の隔たりを返します。

Declaration 宣言 

func distance(from start: Index, to end: Index) -> Int

Parameters パラメータ

start

A valid index of the collection. そのコレクションの有効なインデックス。

end

Another valid index of the collection. If end is equal to start, the result is zero. コレクションの別の有効なインデックス。endがstartに等しいならば、結果はゼロです。

Return Value 戻り値

The distance between start and end. The result can be negative only if the collection conforms to the BidirectionalCollection protocol. startとendの隔たり。結果は、そのコレクションがBidirectionalCollectionプロトコルに準拠する場合に限り、負であることができます。

Discussion 解説

Unless the collection conforms to the BidirectionalCollection protocol, start must be less than or equal to end. コレクションがBidirectionalCollectionプロトコルに準拠しない場合は、startはendより少ないか等しくなければなりません。

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(k), where k is the resulting distance. 計算量：O(1)、もしコレクションがRandomAccessCollectionに準拠するならば；そうでなければ、O(k)、そこでkは結果の隔たりです。

See Also 参照

Manipulating Indices インデックスを操る

var startIndex: Set<Element>.Index
The starting position for iterating members of the set. 集合のメンバを反復するための開始位置。
var endIndex: Set<Element>.Index
The “past the end” position for the set—that is, the position one greater than the last valid subscript argument. 集合に対する「終わりを過ぎた」位置—すなわち、最後の有効な添え字引数より１つ大きい位置。
func index(after: Set<Element>.Index) -> Set<Element>.Index
Returns the position immediately after the given index. 与えられたインデックスの直後の位置を返します。
func formIndex(after: inout Set<Element>.Index)
Replaces the given index with its successor. 与えられたインデックスをそれの後に続くものと取り替えます。
func index(Index, offsetBy: Int) -> Index
Returns an index that is the specified distance from the given index. 与えられたインデックスから指定された隔たりのインデックスを返します。
func formIndex(inout Index, offsetBy: Int)
Offsets the given index by the specified distance. 与えられたインデックスを指定された間隔で補います。
func index(Index, offsetBy: Int, limitedBy: Index) -> Index?
Returns an index that is the specified distance from the given index, unless that distance is beyond a given limiting index. 与えられたインデックスから指定された隔たりのインデックスを返します、その隔たりが与えられた限界インデックスを越えない限りは。
func formIndex(inout Index, offsetBy: Int, limitedBy: Index) -> Bool
Offsets the given index by the specified distance, or so that it equals the given limiting index. 与えられたインデックスをこの指定された隔たりで補います、またはそれでそれは与えられた限界インデックスと等しくなります。
var indices: DefaultIndices<Set<Element>>
The indices that are valid for subscripting the collection, in ascending order. コレクションの添え字に使うのに有効である、昇順でのインデックス。