CPMutableArray Class Reference

#import <CPMutableArray.h>

Inheritance diagram for CPMutableArray:

Instance Methods
(void)	- addObject:
(void)	- addObjectsFromArray:
(void)	- exchangeObjectAtIndex:withObjectAtIndex:
(void)	- insertObject:atIndex:
(unsigned)	- insertObject:inArraySortedByDescriptors:
(void)	- insertObjects:atIndexes:
(void)	- removeAllObjects
(void)	- removeLastObject
(void)	- removeObject:
(void)	- removeObject:inRange:
(void)	- removeObjectAtIndex:
(void)	- removeObjectIdenticalTo:
(void)	- removeObjectIdenticalTo:inRange:
(void)	- removeObjectsAtIndexes:
(void)	- removeObjectsInArray:
(void)	- removeObjectsInRange:
(void)	- replaceObjectAtIndex:withObject:
(void)	- replaceObjectsAtIndexes:withObjects:
(void)	- replaceObjectsInRange:withObjectsFromArray:
(void)	- replaceObjectsInRange:withObjectsFromArray:range:
(void)	- setArray:
(void)	- sortUsingDescriptors:
(void)	- sortUsingFunction:context:
(void)	- sortUsingSelector:
Instance Methods inherited from CPArray
(void)	- addObserver:forKeyPath:options:context:
(void)	- addObserver:toObjectsAtIndexes:forKeyPath:options:context:
(CPArray)	- arrayByAddingObject:
(CPArray)	- arrayByAddingObjectsFromArray:
(CPString)	- componentsJoinedByString:
(BOOL)	- containsObject:
(BOOL)	- containsObjectIdenticalTo:
(id)	- copy
(int)	- count
(CPString)	- description
(void)	- encodeWithCoder:
(void)	- enumerateObjectsUsingBlock:
(void)	- enumerateObjectsWithOptions:usingBlock:
(CPArray)	- filteredArrayUsingPredicate:
(void)	- filterUsingPredicate:
(id)	- firstObject
(id)	- firstObjectCommonWithArray:
(CPIndexSet)	- indexesOfObjectsPassingTest:
(CPIndexSet)	- indexesOfObjectsPassingTest:context:
(CPIndexSet)	- indexesOfObjectsWithOptions:passingTest:
(CPIndexSet)	- indexesOfObjectsWithOptions:passingTest:context:
(CPUInteger)	- indexOfObject:
(CPUInteger)	- indexOfObject:inRange:
(CPUInteger)	- indexOfObject:inSortedRange:options:usingComparator:
(CPUInteger)	- indexOfObjectIdenticalTo:
(CPUInteger)	- indexOfObjectIdenticalTo:inRange:
(unsigned)	- indexOfObjectPassingTest:
(unsigned)	- indexOfObjectPassingTest:context:
(unsigned)	- indexOfObjectWithOptions:passingTest:
(unsigned)	- indexOfObjectWithOptions:passingTest:context:
(id)	- init
(id)	- initWithArray:
(id)	- initWithArray:copyItems:
(id)	- initWithCapacity:
(id)	- initWithCoder:
(id)	- initWithObjects:
(id)	- initWithObjects:count:
(BOOL)	- isEqual:
(BOOL)	- isEqualToArray:
(id)	- lastObject
(void)	- makeObjectsPerformSelector:
(void)	- makeObjectsPerformSelector:withObject:
(void)	- makeObjectsPerformSelector:withObjects:
(id)	- mutableCopy
(id)	- objectAtIndex:
(CPEnumerator)	- objectEnumerator
(CPArray)	- objectsAtIndexes:
(CPArray)	- pathsMatchingExtensions:
(void)	- removeObserver:forKeyPath:
(void)	- removeObserver:fromObjectsAtIndexes:forKeyPath:
(CPEnumerator)	- reverseObjectEnumerator
(void)	- setValue:forKey:
(void)	- setValue:forKeyPath:
(CPArray)	- sortedArrayUsingDescriptors:
(CPArray)	- sortedArrayUsingFunction:
(CPArray)	- sortedArrayUsingFunction:context:
(CPArray)	- sortedArrayUsingSelector:
(CPArray)	- subarrayWithRange:
(id)	- valueForKey:
(id)	- valueForKeyPath:
Instance Methods inherited from CPObject
(void)	- addObserver:forKeyPath:options:context:
(void)	- applyChange:toKeyPath:
(id)	- autorelease
(id)	- awakeAfterUsingCoder:
(void)	- awakeFromCib
(void)	- bind:toObject:withKeyPath:options:
(Class)	- classForCoder
(Class)	- classForKeyedArchiver
(CPString)	- className
(void)	- dealloc
(CPDictionary)	- dictionaryWithValuesForKeys:
(void)	- didChange:valuesAtIndexes:forKey:
(void)	- didChangeValueForKey:
(void)	- didChangeValueForKey:withSetMutation:usingObjects:
(void)	- doesNotRecognizeSelector:
(CPArray)	- exposedBindings
(id)	- forwardingTargetForSelector:
(void)	- forwardInvocation:
(unsigned)	- hash
(BOOL)	- implementsSelector:
(CPDictionary)	- infoForBinding:
(BOOL)	- isKindOfClass:
(BOOL)	- isMemberOfClass:
(BOOL)	- isProxy
(IMP)	- methodForSelector:
(CPMethodSignature)	- methodSignatureForSelector:
(id)	- mutableArrayValueForKey:
(id)	- mutableArrayValueForKeyPath:
(id)	- mutableSetValueForKey:
(id)	- mutableSetValueForKeyPath:
(id)	- performSelector:
(id)	- performSelector:withObject:
(id)	- performSelector:withObject:withObject:
(id)	- performSelector:withObjects:
(void)	- release
(id)	- replacementObjectForArchiver:
(id)	- replacementObjectForCoder:
(id)	- replacementObjectForKeyedArchiver:
(BOOL)	- respondsToSelector:
(id)	- retain
(id)	- self
(void)	- setValue:forUndefinedKey:
(void)	- setValuesForKeysWithDictionary:
(CPString)	- UID
(void)	- unbind:
(Class)	- valueClassForBinding:
(id)	- valueForUndefinedKey:
(void)	- willChange:valuesAtIndexes:forKey:
(void)	- willChangeValueForKey:
(void)	- willChangeValueForKey:withSetMutation:usingObjects:

Class Methods
(CPArray)	+ arrayWithCapacity:
Class Methods inherited from CPArray
(id)	+ alloc
(id)	+ array
(id)	+ arrayWithArray:
(id)	+ arrayWithObject:
(id)	+ arrayWithObjects:
(id)	+ arrayWithObjects:count:
Class Methods inherited from CPObject
(BOOL)	+ accessInstanceVariablesDirectly
(id)	+ allocWithCoder:
(BOOL)	+ automaticallyNotifiesObserversForKey:
(Class)	+ class
(void)	+ exposeBinding:
(void)	+ initialize
(IMP)	+ instanceMethodForSelector:
(BOOL)	+ instancesRespondToSelector:
(BOOL)	+ isSubclassOfClass:
(CPSet)	+ keyPathsForValuesAffectingValueForKey:
(void)	+ load
(id)	+ new
(void)	+ setVersion:
(Class)	+ superclass
(int)	+ version

Additional Inherited Members
Instance Variables inherited from CPObject
Class	isa

Detailed Description

This class is just an empty subclass of CPArray. CPArray already implements mutable methods and this class only exists for source compatability.

Definition at line 2 of file CPMutableArray.h.

Method Documentation

- (void) addObject: (id)  anObject

implementation

Initializes an array able to store at least aCapacity items. Because CPArray is backed by JavaScript arrays, this method ends up simply returning a regular array.

Adds anObject to the end of the array.

Parameters

anObject

the object to add to the array

Definition at line 42 of file CPMutableArray.j.

- (void) addObjectsFromArray: (CPArray)  anArray

implementation

Adds the objects in anArray to the receiver array.

Parameters

anArray

the array of objects to add to the end of the receiver

Definition at line 51 of file CPMutableArray.j.

+ (CPArray) arrayWithCapacity: (unsigned)  aCapacity

implementation

Creates an array able to store at least aCapacity items. Because CPArray is backed by JavaScript arrays, this method ends up simply returning a regular array.

Definition at line 23 of file CPMutableArray.j.

- (void) exchangeObjectAtIndex: (unsigned)  anIndex withObjectAtIndex: (unsigned)  otherIndex

implementation

Swaps the elements at the two specified indices.

Parameters

anIndex	the first index to swap from
otherIndex	the second index to swap from

Definition at line 324 of file CPMutableArray.j.

- (void) insertObject: (id)  anObject atIndex: (int)  anIndex

implementation

Inserts an object into the receiver at the specified location.

Parameters

anObject	the object to insert into the array
anIndex	the location to insert anObject at

Definition at line 65 of file CPMutableArray.j.

- (unsigned) insertObject: (id)  anObject inArraySortedByDescriptors: (CPArray)  descriptors

implementation

Definition at line 95 of file CPMutableArray.j.

- (void) insertObjects: (CPArray)  objects atIndexes: (CPIndexSet)  indexes

implementation

Inserts the objects in the provided array into the receiver at the indexes specified.

Parameters

objects	the objects to add to this array
anIndexSet	the indices for the objects

Definition at line 75 of file CPMutableArray.j.

- (void) removeAllObjects

implementation

Removes all objects from this array.

Definition at line 200 of file CPMutableArray.j.

- (void) removeLastObject

implementation

Removes the last object from the array.

Definition at line 209 of file CPMutableArray.j.

- (void) removeObject: (id)  anObject

implementation

Removes all entries of anObject from the array.

Parameters

anObject

the object whose entries are to be removed

Definition at line 218 of file CPMutableArray.j.

- (void) removeObject: (id)  anObject inRange: (CPRange)  aRange

implementation

Removes all entries of anObject from the array, in the range specified by aRange.

Parameters

anObject	the object to remove
aRange	the range to search in the receiver for the object

Definition at line 228 of file CPMutableArray.j.

- (void) removeObjectAtIndex: (int)  anIndex

implementation

Removes the object at anIndex.

Parameters

anIndex

the location of the element to be removed

Definition at line 243 of file CPMutableArray.j.

- (void) removeObjectIdenticalTo: (id)  anObject

implementation

Remove the first instance of anObject from the array. The search for the object is done using ==.

Parameters

anObject

the object to remove

Definition at line 268 of file CPMutableArray.j.

- (void) removeObjectIdenticalTo: (id)  anObject inRange: (CPRange)  aRange

implementation

Remove the first instance of anObject from the array, within the range specified by aRange. The search for the object is done using ==.

Parameters

anObject	the object to remove
aRange	the range in the array to search for the object

Definition at line 280 of file CPMutableArray.j.

- (void) removeObjectsAtIndexes: (CPIndexSet)  anIndexSet

implementation

Removes the objects at the indices specified by CPIndexSet.

Parameters

anIndexSet

the indices of the elements to be removed from the array

Definition at line 252 of file CPMutableArray.j.

- (void) removeObjectsInArray: (CPArray)  anArray

implementation

Remove the objects in anArray from the receiver array.

Parameters

anArray

the array of objects to remove from the receiver

Definition at line 296 of file CPMutableArray.j.

- (void) removeObjectsInRange: (CPRange)  aRange

implementation

Removes all the objects in the specified range from the receiver.

Parameters

aRange

the range of objects to remove

Definition at line 309 of file CPMutableArray.j.

- (void) replaceObjectAtIndex: (int)  anIndex withObject: (id)  anObject

implementation

Replaces the element at anIndex with anObject. The current element at position anIndex will be removed from the array.

Parameters

anIndex

the position in the array to place anObject

Definition at line 128 of file CPMutableArray.j.

- (void) replaceObjectsAtIndexes: (CPIndexSet)  indexes withObjects: (CPArray)  objects

implementation

Replace the elements at the indices specified by anIndexSet with the objects in objects.

Parameters

anIndexSet	the set of indices to array positions that will be replaced
objects	the array of objects to place in the specified indices

Definition at line 139 of file CPMutableArray.j.

- (void) replaceObjectsInRange: (CPRange)  aRange withObjectsFromArray: (CPArray)  anArray

implementation

Replaces some of the receiver's objects with the objects from anArray. Specifically, the elements of the receiver in the range specified by aRange.

Parameters

aRange	the range of elements to be replaced in the receiver
anArray	the array to retrieve objects for placement into the receiver

Definition at line 178 of file CPMutableArray.j.

- (void) replaceObjectsInRange: (CPRange)  aRange withObjectsFromArray: (CPArray)  anArray range: (CPRange)  otherRange

implementation

Replaces some of the receiver's objects with objects from anArray. Specifically, the elements of the receiver in the range specified by aRange, with the elements of anArray in the range specified by otherRange.

Parameters

aRange	the range of elements to be replaced in the receiver
anArray	the array to retrieve objects for placement into the receiver
otherRange	the range of objects in anArray to pull from for placement into the receiver

Definition at line 159 of file CPMutableArray.j.

- (void) setArray: (CPArray)  anArray

implementation

Sets the contents of the receiver to be identical to the contents of anArray.

Parameters

anArray

the array of objects used to replace the receiver's objects

Definition at line 187 of file CPMutableArray.j.

- (void) sortUsingDescriptors: (CPArray)  descriptors

implementation

Definition at line 335 of file CPMutableArray.j.

- (void) sortUsingFunction: (Function)  aFunction context: (id)  aContext

implementation

Sorts the receiver array using a JavaScript function as a comparator, and a specified context.

Parameters

aFunction	a JavaScript function that will be called to compare objects
aContext	an object that will be passed to aFunction with comparison

Definition at line 354 of file CPMutableArray.j.

- (void) sortUsingSelector: (SEL)  aSelector

implementation

Sorts the receiver array using an Objective-J method as a comparator.

Parameters

aSelector

the selector for the method to call for comparison

Definition at line 363 of file CPMutableArray.j.

---

The documentation for this class was generated from the following files:

• Foundation/CPArray/CPMutableArray.h
• Foundation/CPArray/CPMutableArray.j