Name

NSMutableArray — Mac OS X 10.0

Synopsis

This class extends the API of NSArray to allow for mutable, ordered collections of objects. NSMutableArray provides five primitive methods, which form the basis for the rest of its methods: addObject:, insertObject:atIndex:, removeLastObject, removeObjectAtIndex:, and replaceObjectAtIndex:withObject:. When an object is added to an array, the array asserts some ownership over the object by sending it a retain message. Likewise, when an object is removed from an array, it is sent a release message by the array.

NSMutableArray is toll-free bridged with the Core Foundation type CFArray. As such, NSMutableArray objects can be used interchangeably with the CFArray pointer type, CFArrayRef.

@interface NSMutableArray : NSArray

                                  // Initializers

   - (id)initWithCapacity:(unsigned)numItems;

                                  // Accessor Methods

   - (void)setArray:(NSArray *)otherArray;

                                  // Class Methods

   + (id)arrayWithCapacity:(unsigned)numItems;

                                  // Instance Methods

   - (void)addObject:(id)anObject;

   - (void)addObjectsFromArray:(NSArray *)otherArray;

   - (void)exchangeObjectAtIndex:(unsigned)idx1 
                                 withObjectAtIndex:(unsigned)idx2;

   - (void)insertObject:(id)anObject 
                                 atIndex:(unsigned)index;

   - (void)removeAllObjects;

   - (void)removeLastObject;

   - (void)removeObject:(id)anObject;

   - (void)removeObject:(id)anObject 
                                 inRange:(NSRange)range;

   - (void)removeObjectAtIndex:(unsigned)index;

   - (void)removeObjectIdenticalTo:(id)anObject;

   - (void)removeObjectIdenticalTo:(id)anObject 
                                 inRange:(NSRange)range;

   - (void)removeObjectsFromIndices:(unsigned *)indices 
                                 numIndices:(unsigned)count;

   - (void)removeObjectsInArray:(NSArray *)otherArray;

   - (void)removeObjectsInRange:(NSRange)range;

   - (void)replaceObjectAtIndex:(unsigned)index 
                                 withObject:(id)anObject;

   - (void)replaceObjectsInRange:(NSRange)range 
                                 withObjectsFromArray:(NSArray *)otherArray;

   - (void)replaceObjectsInRange:(NSRange)range 
                                 withObjectsFromArray:(NSArray *)otherArray
                                 range:(NSRange)otherRange;

   - (void)sortUsingFunction:(int (*)(id, id, void *))compare

                                 context:(void *)context;

   - (void)sortUsingSelector:(SEL)comparator;