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

indexOfObject: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 宣言 

- (NSUInteger)indexOfObject:(ObjectType)object 
              inSortedRange:(NSRange)range 
                    options:(NSBinarySearchingOptions)opts 
            usingComparator:(NSComparator)cmp;

Parameters パラメータ

object

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

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

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 NSRangeException. r が順序集合の境界を超えるならば（位置に範囲の長さを足したものが順序集合の総数より大きいならば）、NSRangeExceptionをスローします。

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 NSInvalidArgumentException. この値がNULLならば、NSInvalidArgumentExceptionをスローします。

Return Value 戻り値

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

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

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

  • If the NSBinarySearchingFirstEqual or NSBinarySearchingLastEqual 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 集合メンバにアクセスする

- containsObject:
Returns a Boolean value that indicates whether a given object is present in the ordered set. あるブール値を返します、与えられたオブジェクトが順序集合の中に存在するかどうかを指し示します。
- enumerateObjectsAtIndexes:options:usingBlock:
Executes a given block using the objects in the ordered set at the specified indexes. 与えられたブロックを順序集合の中のオブジェクトそれらを使って、指定されたインデックスそれらで実行します。
- enumerateObjectsUsingBlock:
Executes a given block using each object in the ordered set. 与えられたブロックを順序集合の中の各オブジェクトを使って実行します。
- enumerateObjectsWithOptions:usingBlock:
Executes a given block using each object in the set, using the specified enumeration options. 与えられたブロックを集合の中の各オブジェクトを使って実行します、指定された列挙オプションを使います。
firstObject
The first object in the ordered set. 順序集合の中の最初のオブジェクト。
lastObject
The last object in the ordered set. 順序集合の中の最後のオブジェクト。
- objectAtIndex:
Returns the object at the specified index of the set. 集合の指定されたインデックスでのオブジェクトを返します。
- objectAtIndexedSubscript:
Returns the object at the specified index of the set. 集合の指定されたインデックスでのオブジェクトを返します。
- objectsAtIndexes:
Returns the objects in the ordered set at the specified indexes. 指定されたインデックスでの順序集合の中のオブジェクトを返します。
- indexOfObject:
Returns the index of the specified object. 指定されたオブジェクトのインデックスを返します。
- indexOfObjectAtIndexes:options:passingTest:
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. 順序集合の中のオブジェクトの、ある与えられたインデックス集合からの、インデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格するものです。
- indexOfObjectPassingTest:
Returns the index of the object in the ordered set that passes a test in a given block. 順序集合の中のオブジェクトのインデックスを返します、それは与えられたブロックの中のテストに合格するものです。
- indexOfObjectWithOptions:passingTest:
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. 順序集合の中のあるオブジェクトのインデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格したものです。
- indexesOfObjectsAtIndexes:options:passingTest:
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. 順序集合の中のオブジェクトの、ある与えられたインデックス集合からの、インデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格するものです。
- indexesOfObjectsPassingTest:
Returns the index of the object in the ordered set that passes a test in a given block. 順序集合の中のオブジェクトのインデックスを返します、それは与えられたブロックの中のテストに合格するものです。
- indexesOfObjectsWithOptions:passingTest:
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. 順序集合の中のあるオブジェクトのインデックスを返します、それは与えられたブロックの中のテストをある与えられた列挙オプションの集合に対して合格したものです。
- objectEnumerator
Returns an enumerator object that lets you access each object in the ordered set. あなたに順序集合の各オブジェクトにアクセスさせる列挙子オブジェクトを返します。
- reverseObjectEnumerator
Returns an enumerator object that lets you access each object in the ordered set. あなたに順序集合の各オブジェクトにアクセスさせる列挙子オブジェクトを返します。
reversedOrderedSet
An ordered set in the reverse order. ある順序列挙、逆順で。
- getObjects:range:
Copies the objects contained in the ordered set that fall within the specified range to objects. この順序集合に含まれるオブジェクトで、指定された範囲内に収まるものをobjectsにコピーします。