[Previous]
[Up]
[Next]
NSArray
Authors
- Richard Frith-Macdonald
-
- Pierre-Yves Rivaille
-
Version: $Revision$
Date: $Date$
Declared in: Foundation/NSArray.h
Inherits from: NSObject
Conforms to: NSCoding
Instance Variables
Methods
Class Methods
+ (id) allocWithZone: (NSZone*)zone;
TODO
+ (id) array;
Returns a new empty array.
+ (id) arrayWithArray: (NSArray*)anArray;
Returns a new array containing the same elements as anArray.
+ (id) arrayWithContentsOfFile: (NSString*)aPath;
Returns a new array based upon the file located at aPath.
This file may be in property list format or in XML format (if XML is available).
This method returns nil if the file does not represent an array.
+ (id) arrayWithObject: (id)anObject;
Returns a new array containing only one object, anObject.
+ (id) arrayWithObjects: (id)firstObj,;
Returns a new array containing the objects passed as arguments to the method. The order is preserved.
+ (id) arrayWithObjects: (id*)objects count: (unsigned)count;
Returns a new array containing the objects that are in
the C-array objects and which size is count.
The order is preserved.
Instances Methods
- (NSArray*) arrayByAddingObject: (id)anObject;
Returns a new array created by adding anObject at the end of seld. The order is respected.
- (NSArray*) arrayByAddingObjectsFromArray: (NSArray*)otherArray;
Returns a new array which is the concatenation of self and otherArray (in this precise order).
- (NSString*) componentsJoinedByString: (NSString*)separator;
Returns a string created by the concatenation of self's elements' description separated by the string separator.
The order is preserved.
- (BOOL) containsObject: (id)anObject;
Returns YES if anObject belongs to self. No otherwise. The isEqual: method of anObject is used to test equality.
- (unsigned int) count;
Returns the number of elements contained in self.
- (NSString*) descriptionWithLocale: (NSDictionary*)locale;
TODO
- (NSString*) descriptionWithLocale: (NSDictionary*)locale;
TODO
- (id) firstObjectCommonWithArray: (NSArray*)otherArray;
Returns the first element of the array which can be found in otherArray.
Equality is tested with the isEqual method.
- (void) getObjects: (id*)aBuffer;
This methods store all the elements of self inside aBuffer which is a C-array.
The order is preserved. You should get sure aBuffer's size is sufficient.
- (void) getObjects: (id*)aBuffer range: (NSRange)aRange;
This methods store the elements of self in the range aRange inside aBuffer which is a C-array.
The order is preserved. You should get sure aBuffer's size is sufficient.
- (unsigned int) indexOfObject: (id)anObject;
Returns the index of the first object of the array which is equal to anObject.
Equality is tested with the isEqual: method of anObject.
- (unsigned int) indexOfObject: (id)anObject range: (NSRange)aRange;
Returns the index of the first object of the array which is equal to anObject and which is in aRange range.
Equality is tested with the isEqual: method of anObject.
- (unsigned int) indexOfObjectIdenticalTo: (id)anObject;
Returns the index of the first object of the array which is physically equal to anObject.
Physical equality is tested with ==.
- (unsigned int) indexOfObjectIdenticalTo: (id)anObject range: (NSRange)aRange;
Returns the index of the first object of the array which is physically equal to anObject and which is in aRange range.
Physical equality is tested with ==.
- (id) initWithArray: (NSArray*)anArray;
Initialize the array with the content of anArray. The order is preserved.
Returns self.
- (id) initWithContentsOfFile: (NSString*)aPath;
Initialize the array based upon the file located at aPath.
This file may be in property list format or in XML format (if XML is available).
If the file does not represent an array, self is left uninitialized and nil is returned.
Otherwise self is returned.
- (id) initWithObjects: (id)firstObj,;
Initialize the array with the objects passed as arguments. The order is preserved.
Returns self.
NSInvalidArgumentException is raised if nil is one of the objects.
- (id) initWithObjects: (id*)objects count: (unsigned)count;
Initialize the array with the objects contained in the
C-array argument which size is count.
The order is preserved.
Returns self.
NSInvalidArgumentException is raised if nil is one of the objects.
- (BOOL) isEqualToArray: (NSArray*)otherArray;
Returns YES if the two arrays contain the same elements,
i.e. the two arrays have the same length and
for i from 0 to length - 1,
[[self objectAtIndex: i] isEqual: [anArray objectAtIndex: i]] returns YES.
- (id) lastObject;
Returns the last element of the array. If the array is empty, returns nil.
- (void) makeObjectsPerformSelector: (SEL)aSelector;
Perform aSelector on every object of the array.
This is done sequentially from the last to the first object.
- (void) makeObjectsPerformSelector: (SEL)aSelector withObject: (id)anObject;
Perform aSelector with the argument anObject on every object of the array.
This is done sequentially from the last to the first object.
- (id) objectAtIndex: (unsigned int)index;
Returns located in the array at position index.
Raise NSRangeException if index is out of bounds
- (NSEnumerator*) objectEnumerator;
Returns an enumerator describing the array sequentially
from the first to the last element.
If you use a mutable subclass of NSArray,
you should not modify the array during enumeration
- (NSArray*) pathsMatchingExtensions: (NSArray*)filterTypes;
Returns all the elements of the array which are NSString which
extensions are within the filterTypes NSArray.
- (NSEnumerator*) reverseObjectEnumerator;
Returns an enumerator describing the array sequentially
from the last to the first element.
If you use a mutable subclass of NSArray,
you should not modify the array during enumeration
- (NSData*) sortedArrayHint;
Returns nil. Does not do anything. TODO
- (NSArray*) sortedArrayUsingFunction: (int(*)(id,id,void*))comparator context: (void*)context;
TODO
- (NSArray*) sortedArrayUsingFunction: (int(*)(id,id,void*))compare context: (void*)context;
TODO
- (NSArray*) sortedArrayUsingSelector: (SEL)comparator hint: (NSDate*)hint;
TODO
- (NSArray*) subarrayWithRange: (NSRange)range;
Returns a new array which contains self's elements located in range.
The order is preserved.
- (BOOL) writeToFile: (NSString*)path atomically: (BOOL)flag;
TODO
- (BOOL) writeToURL: (NSURL*)url atomically: (BOOL)flag;
TODO