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

indexOfObject:inSortedRange:options:usingComparator:

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

Declaration 宣言 

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

Parameters パラメータ

obj

An object for which to search in the array. この配列の中で捜すことになるあるオブジェクト。

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

r

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

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

opts

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

If you specify both NSBinarySearchingFirstEqual and NSBinarySearchingLastEqual, throws an NSInvalidArgumentException. あなたがNSBinarySearchingFirstEqualとNSBinarySearchingLastEqualを両方とも指定するならば、NSInvalidArgumentExceptionをスローします。

cmp

A comparator block used to compare the object obj with elements in the array. 比較用ブロック、オブジェクト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 obj is found and neither NSBinarySearchingFirstEqual nor NSBinarySearchingLastEqual is specified, returns any equal or one larger index than any matching object’s index. objが見つけられてNSBinarySearchingFirstEqualもNSBinarySearchingLastEqualも指定されないならば、何らかの合致しているオブジェクトに等しいかより大きい何らかのインデックスが返ります。

  • If the NSBinarySearchingFirstEqual option is also specified, returns the lowest index of equal objects. NSBinarySearchingFirstEqualオプションも同時に指定されるならば、いくつかの同等オブジェクトのうちの最も低いインデックスが返ります。

  • If the NSBinarySearchingLastEqual option is also specified, returns the highest index of equal objects. NSBinarySearchingLastEqualオプションも同時に指定されるならば、いくつかの同等オブジェクトのうちの最も高いインデックスが返ります。

  • 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 array must have already been sorted using the comparator cmp. If the array is not sorted, the result is undefined. 配列の中の要素は、すでに比較子cmpを使ってソートされ終わっていなければなりません。配列がソートされていないならば、結果は未定義です。

See Also 参照

Finding Objects in an Array 配列内のオブジェクトを見つける

- indexOfObject:
Returns the lowest index whose corresponding array value is equal to a given object. 最も低いインデックスで、それの対応する配列値が指定されたオブジェクトと同等であるものを返します。
- indexOfObject:inRange:
Returns the lowest index within a specified range whose corresponding array value is equal to a given object . 指定された範囲内の最も低いインデックスで、それの対応する配列値がある与えられたオブジェクトと同一であるものを返します。
- indexOfObjectIdenticalTo:
Returns the lowest index whose corresponding array value is identical to a given object. 最も低いインデックスで、それの対応する配列値がある与えられたオブジェクトと同一であるものを返します。
- indexOfObjectIdenticalTo:inRange:
Returns the lowest index within a specified range whose corresponding array value is equal to a given object . 指定された範囲内の最も低いインデックスで、それの対応する配列値がある与えられたオブジェクトと同一であるものを返します。
- indexOfObjectPassingTest:
Returns the index of the first object in the array that passes a test in a given block. 配列の中の最初のオブジェクトのインデックスを返します、それは、与えられた「ブロック」の中のテストを合格したものです。
- indexOfObjectWithOptions:passingTest:
Returns the index of an object in the array that passes a test in a given block for a given set of enumeration options. 配列の中の最初のオブジェクトのインデックスを返します、それは、与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格したものです。
- indexOfObjectAtIndexes:options:passingTest:
Returns the index, from a given set of indexes, of the first object in the array that passes a test in a given block for a given set of enumeration options. 配列の中の最初のオブジェクトのインデックスを、与えられた一揃いのインデックスから返します、それは、与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格したものです。
- indexesOfObjectsPassingTest:
Returns the indexes of objects in the array that pass a test in a given block. 配列中のオブジェクトのインデックスを返します、それは与えられた「ブロック」の中のテストを合格するものです。
- indexesOfObjectsWithOptions:passingTest:
Returns the indexes of objects in the array that pass a test in a given block for a given set of enumeration options. 配列の中のオブジェクトのインデックスを返します、それは与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格するものです。
- indexesOfObjectsAtIndexes:options:passingTest:
Returns the indexes, from a given set of indexes, of objects in the array that pass a test in a given block for a given set of enumeration options. 配列の中のいくらかのオブジェクトのインデックスを、与えられた一揃いのインデックスから返します、それは、与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格したものです。