NSMutableArray Class Reference

Inherits NSArray.

Inherited by _EOCheapCopyMutableArray, SubList, ERXBatchingDisplayGroup< T >.FakeArray, ERXSortOrdering.ERXSortOrderings, and ERXMutableArray< E >.

Collaboration diagram for NSMutableArray:

[legend]

List of all members.

Classes
class	Itr
class	ListItr
Public Member Functions
void	_moveObjectAtIndexToIndex (int sourceIndex, int destIndex)
boolean	add (Object element)
void	add (int index, Object element)
boolean	addAll (int index, Collection collection)
boolean	addAll (Collection collection)
void	addObject (Object object)
void	addObjects (Object objects[])
void	addObjectsFromArray (NSArray otherArray)
void	clear ()
Object	clone ()
NSArray	immutableClone ()
void	insertObjectAtIndex (Object object, int index)
Iterator	iterator ()
ListIterator	listIterator (final int index)
ListIterator	listIterator ()
NSMutableArray	mutableClone ()
	NSMutableArray (Vector vector, NSRange range, boolean ignoreNull)
	NSMutableArray (NSArray otherArray)
	NSMutableArray (Object objects[], NSRange range)
	NSMutableArray (Object objects[])
	NSMutableArray (Object object)
	NSMutableArray (int capacity)
	NSMutableArray ()
boolean	remove (Object o)
Object	remove (int index)
boolean	removeAll (Collection collection)
void	removeAllObjects ()
boolean	removeIdenticalObject (Object object, NSRange range)
boolean	removeIdenticalObject (Object object)
Object	removeLastObject ()
boolean	removeObject (Object object, NSRange range)
boolean	removeObject (Object object)
Object	removeObjectAtIndex (int index)
void	removeObjects (Object otherObjects[])
void	removeObjectsInArray (NSArray otherArray)
void	removeObjectsInRange (NSRange range)
Object	replaceObjectAtIndex (Object object, int index)
void	replaceObjectAtIndex (int index, Object object)
void	replaceObjectsInRange (NSRange range, NSArray otherArray, NSRange otherRange)
boolean	retainAll (Collection c)
Object	set (int index, Object element)
void	setArray (NSArray otherArray)
void	sortUsingComparator (NSComparator comparator) throws NSComparator.ComparisonException
List	subList (int fromIndex, int toIndex)
Object[]	toArray (Object array[])
Static Public Attributes
static final Class	_CLASS = _NSUtilitiesExtra._classWithFullySpecifiedNamePrime("com.webobjects.foundation.NSMutableArray")
static final Object	ERX_MARKER = "Wonder"
Protected Member Functions
void	removeRange (int fromIndex, int toIndex)
Protected Attributes
transient int	modCount = 0
Static Package Attributes
static final long	serialVersionUID = -3909373569895711876L
Private Member Functions
boolean	_removeObject (Object object, int index, int length, boolean identical)
void	clearCache ()

---

Detailed Description

Bugfix reimplementation of NSMutableArray. To be able to use this class, the framework this class resides in must be before JavaFoundation.framework in your classpath.
It fixes a lot of issues:

• implements the correct Collection methods, so you can anArray.add(anObject)
• has several performance improvements that make EOF faster by several orders of magnitude when you have large record sets
• fixes a bug when the actual objects were handed out replaceObjectAtIndex()
• fixes a bug when the iterator method wasn't firing a fault in _EOCheapCopyMutableArray

Once these issues are resolved in a WO distribution, this class will go away and the Apple supplied will will be used again without changes in code on your side.

Author:

ak

---

Constructor & Destructor Documentation

NSMutableArray

(

)

NSMutableArray

(

int

capacity

)

NSMutableArray

(

Object

object

)

NSMutableArray

(

Object

objects[]

)

NSMutableArray	(	Object	objects[],
		NSRange	range
	)

NSMutableArray

(

NSArray

otherArray

)

NSMutableArray	(	Vector	vector,
		NSRange	range,
		boolean	ignoreNull
	)

---

Member Function Documentation

void _moveObjectAtIndexToIndex	(	int	sourceIndex,
		int	destIndex
	)

boolean _removeObject	(	Object	object,
		int	index,
		int	length,
		boolean	identical
	)			[private]

boolean add

(

Object

element

)

void add	(	int	index,
		Object	element
	)

Reimplemented in SubList.

boolean addAll	(	int	index,
		Collection	collection
	)

Reimplemented in SubList.

boolean addAll

(

Collection

collection

)

Reimplemented in SubList.

void addObject

(

Object

object

)

Reimplemented in _EOCheapCopyMutableArray.

void addObjects

(

Object

objects[]

)

Reimplemented in _EOCheapCopyMutableArray.

void addObjectsFromArray

(

NSArray

otherArray

)

void clear

(

)

void clearCache

(

)

[private]

Clears out the object cache and tell us to recompute the hash.

Object clone

(

)

Reimplemented in _EOCheapCopyMutableArray.

NSArray immutableClone

(

)

Reimplemented in _EOCheapCopyMutableArray.

void insertObjectAtIndex	(	Object	object,
		int	index
	)

Reimplemented in _EOCheapCopyMutableArray.

Iterator iterator

(

)

Reimplemented in SubList.

ListIterator listIterator

(

final int

index

)

Reimplemented in SubList.

ListIterator listIterator

(

)

NSMutableArray mutableClone

(

)

Reimplemented in ERXMutableArray< E >.

boolean remove

(

Object

o

)

Object remove

(

int

index

)

Reimplemented in SubList.

boolean removeAll

(

Collection

collection

)

void removeAllObjects

(

)

Reimplemented in _EOCheapCopyMutableArray.

boolean removeIdenticalObject	(	Object	object,
		NSRange	range
	)

boolean removeIdenticalObject

(

Object

object

)

Object removeLastObject

(

)

boolean removeObject	(	Object	object,
		NSRange	range
	)

boolean removeObject

(

Object

object

)

Object removeObjectAtIndex

(

int

index

)

Reimplemented in _EOCheapCopyMutableArray.

void removeObjects

(

Object

otherObjects[]

)

Much faster implementation of the remove method for larger arrays.

void removeObjectsInArray

(

NSArray

otherArray

)

void removeObjectsInRange

(

NSRange

range

)

void removeRange	(	int	fromIndex,
		int	toIndex
	)			[protected]

Reimplemented in SubList.

Object replaceObjectAtIndex	(	Object	object,
		int	index
	)

Clears the objectsNoCopy too. It's wrong not to clear it.

Reimplemented in _EOCheapCopyMutableArray.

void replaceObjectAtIndex	(	int	index,
		Object	object
	)

Deprecated:

Method replaceObjectAtIndex is deprecated

void replaceObjectsInRange	(	NSRange	range,
		NSArray	otherArray,
		NSRange	otherRange
	)

boolean retainAll

(

Collection

c

)

Object set	(	int	index,
		Object	element
	)

Reimplemented in SubList.

void setArray

(

NSArray

otherArray

)

Reimplemented in _EOCheapCopyMutableArray.

void sortUsingComparator

(

NSComparator

comparator

)

throws NSComparator.ComparisonException

Reimplemented in _EOCheapCopyMutableArray.

List subList	(	int	fromIndex,
		int	toIndex
	)

Reimplemented in SubList, and RandomAccessSubList.

Object [] toArray

(

Object

array[]

)

Bugfix for the broken implementation in NSArray.

---

Member Data Documentation

final Class _CLASS = _NSUtilitiesExtra._classWithFullySpecifiedNamePrime("com.webobjects.foundation.NSMutableArray") [static]

Reimplemented in _EOCheapCopyMutableArray.

final Object ERX_MARKER = "Wonder" [static]

transient int modCount = 0 [protected]

final long serialVersionUID = -3909373569895711876L [static, package]

Reimplemented in _EOCheapCopyMutableArray, and ERXMutableArray< E >.

---

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

• /opt/source/Wonder/Frameworks/Core/ERExtensions/PatchesJDK1.4/com/webobjects/foundation/NSMutableArray.java