文書   >   Swift   >   Swift 標準ライブラリ   >   Collections   >   Sequence and Collection Protocols   >   Collection   >   index(_:offsetBy:limitedBy:)   >   index(_:offsetBy:limitedBy:)     廃止  


汎用インスタンスメソッド


index(_:offsetBy:limitedBy:)


与えられた限界のインデックスを越えた距離でなければ、与えられたインデックスから指定された距離にあるインデックスを返します。





宣言


func index<T>(_ i: Self.Index, offsetBy n: T, limitedBy limit: Self.Index) ->
	 Self.Index? where T : BinaryInteger


パラメータ


iコレクションの有効なインデックス。
distanceoffset i までの距離。コレクションが BidirectionalCollection プロトコルに準拠していない場合、 distance は負であってはなりません。
limit限界として使用するコレクションの有効なインデックス。distance > 0 の場合、i 未満の限界は無効です。同様に、distance < 0 の場合、i より大きい限界は無効です。


戻り値


そのインデックスが移動方向の限界 (limit) を超えない場合、インデックス i からの distance だけオフセットされたインデックス。その場合、このメソッドは nil を返します。


議論


以下の例では、文字列の開始インデックスから 4 つの位置だけ進んだインデックスを取得し、その位置にある文字を表示します。この操作は、制限された s.endIndex 値を超える必要はないため、成功します。



let s = "Swift"
let i = s.index(s.startIndex, offsetBy: 4, limitedBy: s.endIndex)
print(s[i])
// Prints "t"



次の例では、s.startIndex から 6 つの位置にあるインデックスを取得しようとしますが、その距離は limit として渡されたインデックスを超えているため失敗します。



let j = s.index(s.startIndex, offsetBy: 6, limitedBy: s.endIndex)
print(j)
// Prints "nil"



distance として渡される値は、limit として渡されるインデックスがそれらの境界を越えてオフセットするのを防がない限り、コレクションの境界を超えて i をオフセットしてはなりません。


複雑さ:コレクションが RandomAccessCollection に準拠している場合は O(1)。そうでなければ、O(k)、ここで kdistance の絶対値です。


関連





汎用の制約


T : BinaryInteger


以下も見よ





コレクションの実装





目次
Xcode の新機能

  • SDK
  • Xcode 7.1-9.3     廃止  
  • フレームワーク
  • Swift 標準ライブラリ
  • 宣言
  • パラメータ
  • 戻り値
  • 議論
  • 関連
  • 以下も見よ












  • トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)












    トップへ(Swift 標準ライブラリ)