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

index(of:inSortedRange:options:usingComparator:)

Returns the index, within a specified range, of an object compared with elements in the ordered set using a given NSComparator block. 順序集合の中の要素とある与えられたNSComparatorブロックを使って比較された、指定された範囲内での、あるオブジェクトのインデックスを返します。

Declaration 宣言 

func index(of object: Any, 
inSortedRange range: NSRange, 
   options opts: NSBinarySearchingOptions = [], 
usingComparator cmp: (Any, Any) -> ComparisonResult) -> Int

Parameters パラメータ

object

An object for which to search in the ordered set. それを求めてこの順序集合の中を検索することになるオブジェクト。

If this value is nil, throws an invalidArgumentException. この値がnilならば、invalidArgumentExceptionをスローします。

range

The range within the array to search for object. 配列内のこの範囲をobjectについて検索することになります。

If r exceeds the bounds of the ordered set (if the location plus length of the range is greater than the count of the ordered set), throws an rangeException. r が順序集合の境界を超えるならば（位置に範囲の長さを足したものが順序集合の総数より大きいならば）、rangeExceptionをスローします。

opts

Options for the search. For possible values, see NSBinarySearchingOptions. 検索のオプション。可能な値としては、NSBinarySearchingOptionsを見てください。

cmp

A comparator block used to compare the object obj with elements in the ordered set. 比較用ブロック、オブジェクト obj を順序集合の中の要素と比較するのに使われます。

If this value is NULL, throws an invalidArgumentException. この値がNULLならば、invalidArgumentExceptionをスローします。

Return Value 戻り値

If the insertionIndex option is not specified: insertionIndexオプションが指定されないならば：

  • If the object is found and neither firstEqual nor lastEqual is specified, returns the matching object's index. objectが見つけられてfirstEqualもlastEqualも指定されないならば、合致しているオブジェクトのインデックスが返ります。

  • If the firstEqual or lastEqual option is also specified, returns the index of equal objects. firstEqualまたはlastEqualオプションもまた指定されるならば、等しいオブジェクトのインデックスが返ります。

  • If the object is not found, returns NSNotFound. オブジェクトが見つけられないならば、NSNotFoundが返ります。

If the insertionIndex option is specified, returns the index at which you should insert obj in order to maintain a sorted array: insertionIndexオプションが指定されるならば、あなたがソートされた配列を整備する目的でobjを挿入すべきところのインデックスを返します：

  • If the object is found and neither firstEqual nor lastEqual is specified, returns the matching object’s index. objectが見つけられてfirstEqualもlastEqualも指定されないならば、合致しているオブジェクトのインデックスが返ります。

  • If the firstEqual or lastEqual option is also specified, returns the index of the equal objects.

  • If the object is not found, returns the index of the least greater object, or the index at the end of the array if the object is larger than all other elements. オブジェクトが見つけられないならば、最小のより大きいオブジェクトのインデックス、またはオブジェクトが全ての他の要素より大きいならば配列の最後のインデックスが返ります。

Discussion 議論

The elements in the ordered set must have already been sorted using the comparator cmp. If the ordered set is not sorted, the result is undefined. 順序集合がソートされていないならば、結果は未定義です。

See Also 参照

Accessing Set Members 集合メンバにアクセスする

func contains(Any) -> Bool
Returns a Boolean value that indicates whether a given object is present in the ordered set. あるブール値を返します、与えられたオブジェクトが順序集合の中に存在するかどうかを指し示します。
func enumerateObjects(at: IndexSet, options: NSEnumerationOptions, using: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Void)
Executes a given block using the objects in the ordered set at the specified indexes. 与えられたブロックを順序集合の中のオブジェクトそれらを使って、指定されたインデックスそれらで実行します。
func enumerateObjects((Any, Int, UnsafeMutablePointer<ObjCBool>) -> Void)
Executes a given block using each object in the ordered set. 与えられたブロックを順序集合の中の各オブジェクトを使って実行します。
func enumerateObjects(options: NSEnumerationOptions, using: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Void)
Executes a given block using each object in the set, using the specified enumeration options. 与えられたブロックを集合の中の各オブジェクトを使って実行します、指定された列挙オプションを使います。
var firstObject: Any?
The first object in the ordered set. 順序集合の中の最初のオブジェクト。
var lastObject: Any?
The last object in the ordered set. 順序集合の中の最後のオブジェクト。
func object(at: Int) -> Any
Returns the object at the specified index of the set. 集合の指定されたインデックスでのオブジェクトを返します。
subscript(Int) -> Any
Returns the object at the specified index of the set. 集合の指定されたインデックスでのオブジェクトを返します。
func objects(at: IndexSet) -> [Any]
Returns the objects in the ordered set at the specified indexes. 指定されたインデックスでの順序集合の中のオブジェクトを返します。
func index(of: Any) -> Int
Returns the index of the specified object. 指定されたオブジェクトのインデックスを返します。
func index(ofObjectAt: IndexSet, options: NSEnumerationOptions, passingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int
Returns the index, from a given set of indexes, of the object in the ordered set that passes a test in a given block for a given set of enumeration options. 順序集合の中のオブジェクトの、ある与えられたインデックス集合からの、インデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格するものです。
func index(ofObjectPassingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int
Returns the index of the object in the ordered set that passes a test in a given block. 順序集合の中のオブジェクトのインデックスを返します、それは与えられたブロックの中のテストに合格するものです。
func index(NSEnumerationOptions, ofObjectPassingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int
Returns the index of an object in the ordered set that passes a test in a given block for a given set of enumeration options. 順序集合の中のあるオブジェクトのインデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格したものです。
func indexes(ofObjectsAt: IndexSet, options: NSEnumerationOptions, passingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> IndexSet
Returns the index, from a given set of indexes, of the object in the ordered set that passes a test in a given block for a given set of enumeration options. 順序集合の中のオブジェクトの、ある与えられたインデックス集合からの、インデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格するものです。
func indexes(ofObjectsPassingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> IndexSet
Returns the index of the object in the ordered set that passes a test in a given block. 順序集合の中のオブジェクトのインデックスを返します、それは与えられたブロックの中のテストに合格するものです。
func indexes(options: NSEnumerationOptions, ofObjectsPassingTest: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> IndexSet
Returns the index of an object in the ordered set that passes a test in a given block for a given set of enumeration options. 順序集合の中のあるオブジェクトのインデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格したものです。
func objectEnumerator() -> NSEnumerator
Returns an enumerator object that lets you access each object in the ordered set. あなたに順序集合の各オブジェクトにアクセスさせる列挙子オブジェクトを返します。
func reverseObjectEnumerator() -> NSEnumerator
Returns an enumerator object that lets you access each object in the ordered set. あなたに順序集合の各オブジェクトにアクセスさせる列挙子オブジェクトを返します。
var reversed: NSOrderedSet
An ordered set in the reverse order. ある順序列挙、逆順で。