Inherits From:
NSObject
Conforms To:
NSObject (NSObject)
Declared In:
Foundation/NSUtilities.h
objectEnumerator
method
or NSDictionary's keyEnumerator
method.
- nextObject | Returns the next object in the collection being enumerated. |
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 can't "reset" an enumerator after it's exhausted its collection. To enumerate a collection again, you need a new enumerator.
Collection classes such as NSArray, NSSet, and NSDictionary include methods that return an enumerator appropriate to the type of collection. For instance, 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 an NSDictionary by key or by value, respectively.
allObjects
Returns an array of the objects the receiver has yet to enumerate. The array returned by this method does not contain objects that have already been enumerated with previous nextObject
messages. Invoking this method exhausts the enumerator's collection so that subsequent invocations of nextObject
return nil
.
nextObject
Returns the next object from the collection being enumerated. When nextObject
returns nil
, all objects have been enumerated. The following code illustrates how this works using NSArray:
NSEnumerator *enumerator = [anArray objectEnumerator];
id object;
while ((object = [enumerator nextObject])) {
// do something with object...
}