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

enumerateObjectsWithOptions:usingBlock:

Executes a given block using each object in the array with the specified options. 与えられたブロックを配列の中の各オブジェクトを使って指定されたオプションで実行します。

Declaration 宣言

- (void)enumerateObjectsWithOptions:(NSEnumerationOptions)opts 
                         usingBlock:(void (^)(ObjectType obj, NSUInteger idx, BOOL *stop))block;

Parameters パラメータ

opts

The options for the enumeration. For possible values, see NSEnumerationOptions. 列挙に対するオプション。可能な値として、NSEnumerationOptionsを見てください。

block

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

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

obj

The object. そのオブジェクト。

idx

The index of the object in the array. 配列におけるそのオブジェクトのインデックス。

stop 中止

A reference to a Boolean value. Setting the value to YES within the block stops 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. あるブール値への参照。値をYESへとブロック内で設定することは、配列のそれ以上の列挙を停止します。あるブロックがその先の列挙を止めるならば、そのブロックはそれがやり終えられるまで実行を継続します。NSEnumerationConcurrent列挙オプションが指定される場合、列挙は、現在実行しているいくつかのブロックすべてがやり終える後に停止します。

Discussion 議論

This method executes synchronously. 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 参照

Sending Messages to Elements 要素にメッセージを送る