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

indexOfObject(options: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. 配列の中の最初のオブジェクトのインデックスを返します、それは、与えられた「ブロック」の中のテストを一式の与えられた列挙オプションで合格したものです。

Declaration 宣言

func indexOfObject(options opts: NSEnumerationOptions = [], 
       passingTest predicate: (Any, Int, UnsafeMutablePointer<ObjCBool>) -> Bool) -> Int

Parameters パラメータ

opts

A bit mask that specifies the options for the enumeration (whether it should be performed concurrently and whether it should be performed in reverse order). あるビットマスク、それは、列挙のためのオプションを指定します(それが並行に実行されるべきかどうかそしてそれが逆順に実行されるべきかどうか)。

predicate

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

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

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 true to stop further enumeration of the array. If a block stops further enumeration, that block continues to run until it’s finished. When the NSEnumerationConcurrent enumeration option is specified, enumeration stops after all of the currently running blocks finish. The stop argument is an out-only argument. You should only ever set this Boolean to true within the block. あるブール値への参照。ブロックはtrueに設定されることで、それ以上の配列の列挙を止めることができます。あるブロックがその先の列挙を止めるならば、そのブロックはそれがやり終えられるまで実行を継続します。NSEnumerationConcurrent列挙オプションが指定される場合、列挙は、現在実行しているいくつかのブロックすべてがやり終える後に停止します。stop引数は、ひとつの退出専用引数です。あなたは、「ブロック」内でこのブールをtrueに設定できるだけであるべきです。

The block returns a Boolean value that indicates whether obj passed the test. この「ブロック」はobjがテストを合格したかどうかを示すブール値を返します。

Return Value 戻り値

The index whose corresponding value in the array passes the test specified by predicate and opts. If the opts bit mask specifies reverse order, then the last item that matches is returned. Otherwise, the index of the first matching object is returned. If no objects in the array pass the test, returns NSNotFound. それの対応する配列の中の値がpredicateによって指定されるテストそしてoptsを合格するインデックス。optsビットマスクが逆順を指定するならば、そのときは合致する最後の項目が返されます。そうでなければ、最初の合致するオブジェクトのインデックスが返されます。配列の中にテストを合格するオブジェクトが1つもないならば、NSNotFoundを返します。

Discussion 議論

By default, the enumeration starts with the first object and continues serially through the array to the last object. You can specify NSEnumerationConcurrent and/or NSEnumerationReverse as enumeration options to modify this behavior. 初期状態では、列挙は最初のオブジェクトで開始して順次その配列を最後のオブジェクトまで続けます。あなたは、NSEnumerationConcurrentおよび/またはNSEnumerationReverseを列挙オプションとして指定してこの挙動を変えることができます。

See Also 参照

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