XCode 7.3 日本語化計画：API:NSEnumerator

NSEnumerator

継承：NSObject(Class)

従属：NSObject(protocol)、NSFastEnumeration

フレームワーク：OS X 10.5 以降の Foundation。関連項目

概観

NSEnumerator は、抽象クラスであり、配列や辞書のような他のオブジェクトのコレクションを、列挙するそのサブクラスのインスタンスです。

すべての作成メソッドは、NSArray、NSSet、NSDictionary のようなコレクションクラスに定義されており、その内容を列挙するために、特別な NSEnumerator オブジェクトを提供しています。例えば、NSArray には NSEnumerator オブジェクトを返す２つのメソッドがあり、objectEnumerator と reverseObjectEnumerator です。NSDictionary にも NSEnumerator オブジェクトを返す２つのメソッドがあり、keyEnumerator と objectEnumerator です。これらのメソッドを使用すると、それぞれ、キーまたは値によって辞書の内容を列挙できます。

それが元のコレクション内の次のオブジェクトを返すのを待って、新しく作成された NSEnumerator オブジェクトに繰り返し nextObject を送信して下さい。コレクションがなくなると、nil　が返されます。そのコレクションを使い果たした後は、列挙子を"リセット"することはできません。もう一度コレクションを列挙するには、新しい列挙子を必要とします。

NSArray、NSDictionary、および NSSet で使用される列挙サブクラスは、列挙中にコレクションを保持しています。列挙が使い果たされると、コレクションは解除されます。

タスク

列挙されたオブジェクトの取得

allObjects プロパティ

列挙されていないオブジェクトの配列。(読み取り専用)

宣言

<< SWIFT >>

var allObjects: [AnyObject] { get }

<< OBJECTIVE-C >>

@property(readonly, copy) NSArray < ObjectType > *allObjects

議論

この配列は、列挙された順に列挙子の残りのすべてのオブジェクトを含んでいます。これは、すでに前の nextObject メッセージで列挙されたオブジェクトは含まれていません。

利用可能

OS X v10.0 以降で利用可能。

- nextObject

列挙されつつあるコレクションから次のオブジェクトを返します。

宣言

<< SWIFT >>

func nextObject() -> AnyObject?

<< OBJECTIVE-C >>

- (ObjectType)nextObject

戻り値

列挙しつつあるコレクションから次のオブジェクトを、またはすべてのオブジェクトが列挙されてしまったときには nil を返します。

議論

このメソッドが、配列を使用して、どのように機能するかを次のコードで示します。

<< OBJECTIVE-C >>

1. NSArray *anArray = // ... ;
2. NSEnumerator *enumerator = [anArray objectEnumerator];
3. id object;
5. while ((object = [enumerator nextObject])) {
6.         // do something with object...
7. }

利用可能

OS X v10.0 以降で利用可能