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

indexOfObjectPassingTest:

Returns the index of the first object in the array that passes a test in a given block. 配列の中の最初のオブジェクトのインデックスを返します、それは、与えられた「ブロック」の中のテストを合格したものです。

Declaration 宣言 

- (NSUInteger)indexOfObjectPassingTest:(BOOL (^)(ObjectType obj, NSUInteger idx, BOOL *stop))predicate;

Parameters パラメータ

predicate

The block to apply to elements in the array. 配列の中の要素に適用されることになるブロック。

The block takes three arguments: ブロックは、次の３つの引数をとります：

obj

The element in the array. 配列の中の要素。

idx

The index of the element in the array. 配列の中の要素のインデックス。

stop 中止

A reference to a Boolean value. The block can set the value to YES to stop further enumeration of the array. If a block stops further enumeration, that block continues to run until it’s finished. The stop argument is an out-only argument. You should only ever set this Boolean to YES within the block. あるブール値への参照。ブロックはYESに設定されることで、それ以上の配列の処理を止めることができます。あるブロックがその先の列挙を止めるならば、そのブロックはそれがやり終えられるまで実行を継続します。stop引数は、ひとつの退出専用引数です。あなたは、常に「ブロック」内部でこのブールをYESに設定できるだけであるべきです。

The block returns a Boolean value that indicates whether obj passed the test. Returning YES will stop further processing of the array. この「ブロック」はobjがテストを合格したかどうかを示すブール値を返します。YESを返しているのは、それ以上の配列の処理を止めています。

Return Value 戻り値

The lowest index whose corresponding value in the array passes the test specified by predicate. If no objects in the array pass the test, returns NSNotFound. 配列の中のそれの対応する値がpredicateによって指定されるテストを合格する最も低いインデックス。配列の中にテストを合格するオブジェクトが１つもないならば、NSNotFoundを返します。

Discussion 議論

If the block parameter is nil this method will raise an exception. 「ブロック」パラメータがnilならばこのメソッドは例外を引き起こすでしょう。

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 . 指定された範囲内の最も低いインデックスで、それの対応する配列値がある与えられたオブジェクトと同一であるものを返します。
- 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. 配列の中のいくらかのオブジェクトのインデックスを、与えられた一揃いのインデックスから返します、それは、与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格したものです。
- 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ブロックを使って配列の中の要素と比較される、指定された範囲内の、あるオブジェクトのインデックスを返します。