NSEnumerator

class NSEnumerator : NSObject

Overview 概要

All creation methods are defined in the collection classes—such as NSArray, NSSet, and NSDictionary—which provide special NSEnumerator objects with which to enumerate their contents. For example, NSArray has two methods that return an NSEnumerator object: objectEnumerator() and reverseObjectEnumerator(). NSDictionary also has two methods that return an NSEnumerator object: keyEnumerator() and objectEnumerator(). These methods let you enumerate the contents of a dictionary by key or by value, respectively. 全ての作成メソッドは、いくつかのコレクションクラスにおいて定義されます — 例えばNSArray、NSSet、そしてNSDictionaryなど — それらは特別なNSEnumeratorオブジェクトを提供し、それでそれらの内容を列挙します。例えば、NSArrayは２つのメソッドを持ち、それらはNSEnumeratorオブジェクト：objectEnumerator()とreverseObjectEnumerator()を返します。NSDictionaryもまた２つのメソッドをもち、それらはNSEnumeratorオブジェクト：keyEnumerator()とobjectEnumerator()を返します。それらのメソッドはあなたにある辞書の内容を、それぞれキーによってまたは値によって列挙させます。

You send nextObject() repeatedly to a newly created NSEnumerator object to have it return the next object in the original collection. When the collection is exhausted, nil is returned. You cannot “reset” an enumerator after it has exhausted its collection. To enumerate a collection again, you need a new enumerator. あなたは、nextObject()を繰り返しある新しく作成されたNSEnumeratorオブジェクトに送ることで、それに元のコレクションの中の次のオブジェクトを返させます。コレクションが使い果たされる場合、nilが返されます。あなたは列挙子の “再設定” を、それがそれのコレクションを使い果たした後に行うことはできません。あるコレクションを再び列挙するには、あなたは新しい列挙しが必要です。

The enumerator subclasses used by NSArray, NSDictionary, and NSSet retain the collection during enumeration. When the enumeration is exhausted, the collection is released. NSArray、NSDictionary、そしてNSSetによって使われる列挙子サブクラスは、列挙の間にコレクションを保持します。列挙が使い果たされる時、コレクションは解放されます。