com.dd.plist

Class NSArray

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.NSArray

public class NSArray
extends NSObject

Represents an Array.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Constructor and Description
NSArray(int length) Creates an empty array of the given length.
NSArray(NSObject... a) Creates a array from an existing one

Method Summary

Methods

Modifier and Type	Method and Description
boolean	containsObject(NSObject obj) Checks whether an object is present in the array or whether it is equal to any of the objects in the array.
int	count() Returns the size of the array.
boolean	equals(Object obj)
NSObject[]	getArray() Returns the array of NSObjects represented by this NSArray.
int	hashCode()
int	indexOfIdenticalObject(NSObject obj) Searches for an object in the array.
int	indexOfObject(NSObject obj) Searches for an object in the array.
NSObject	lastObject() Returns the last object contained in this array.
NSObject	objectAtIndex(int i) Returns the object stored at the given index.
NSObject[]	objectsAtIndexes(int... indexes) Returns a new array containing only the values stored at the given indices.
void	remove(int i) Remove the i-th element from the array.
void	setValue(int key, NSObject value) Stores an object at the specified index.
protected void	toASCII(StringBuilder ascii, int level) Generates the ASCII representation of this object.
protected void	toASCIIGnuStep(StringBuilder ascii, int level) Generates the ASCII representation of this object in the GnuStep format.
String	toASCIIPropertyList() Generates a valid ASCII property list which has this NSArray as its root object.
String	toGnuStepASCIIPropertyList() Generates a valid ASCII property list in GnuStep format which has this NSArray as its root object.

Methods inherited from class com.dd.plist.NSObject

toJavaObject, toXMLPropertyList, wrap, wrap, wrap, wrap, wrap, wrap, wrap, wrap, wrap, wrap, wrapSerialized

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NSArray

public NSArray(int length)

Creates an empty array of the given length.

Parameters:

length - The number of elements this array will be able to hold.

NSArray

public NSArray(NSObject... a)

Creates a array from an existing one

Parameters:

a - The array which should be wrapped by the NSArray

Method Detail

objectAtIndex

public NSObject objectAtIndex(int i)

Returns the object stored at the given index. Equivalent to getArray()[i].

Parameters:

i - The index of the object.

Returns:

The object at the given index.

remove

public void remove(int i)

Remove the i-th element from the array. The array will be resized.

Parameters:

i - The index of the object

setValue

public void setValue(int key,
            NSObject value)

Stores an object at the specified index. If there was another object stored at that index it will be replaced. Equivalent to getArray()[key] = value.

Parameters:

key - The index where to store the object.

value - The object.

getArray

public NSObject[] getArray()

Returns the array of NSObjects represented by this NSArray. Any changes to the values of this array will also affect the NSArray.

Returns:

The actual array represented by this NSArray.

count

public int count()

Returns the size of the array.

Returns:

The number of elements that this array can store.

containsObject

public boolean containsObject(NSObject obj)

Checks whether an object is present in the array or whether it is equal to any of the objects in the array.

Parameters:

obj - The object to look for.

Returns:

true, when the object could be found. false otherwise.

See Also:

Object.equals(java.lang.Object)

indexOfObject

public int indexOfObject(NSObject obj)

Searches for an object in the array. If it is found its index will be returned. This method also returns an index if the object is not the same as the one stored in the array but has equal contents.

Parameters:

obj - The object to look for.

Returns:

The index of the object, if it was found. -1 otherwise.

See Also:

Object.equals(java.lang.Object), indexOfIdenticalObject(com.dd.plist.NSObject)

indexOfIdenticalObject

public int indexOfIdenticalObject(NSObject obj)

Searches for an object in the array. If it is found its index will be returned. This method only returns the index of an object that is identical to the given one. Thus objects that might contain the same value as the given one will not be considered.

Parameters:

obj - The object to look for.

Returns:

The index of the object, if it was found. -1 otherwise.

See Also:

indexOfObject(com.dd.plist.NSObject)

lastObject

public NSObject lastObject()

Returns the last object contained in this array. Equivalent to getArray()[getArray().length-1].

Returns:

The value of the highest index in the array.

objectsAtIndexes

public NSObject[] objectsAtIndexes(int... indexes)

Returns a new array containing only the values stored at the given indices. The values are sorted by their index.

Parameters:

indexes - The indices of the objects.

Returns:

The new array containing the objects stored at the given indices.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toASCIIPropertyList

public String toASCIIPropertyList()

Generates a valid ASCII property list which has this NSArray as its root object. The generated property list complies with the format as described in Property List Programming Guide - Old-Style ASCII Property Lists.

Returns:

ASCII representation of this object.

toGnuStepASCIIPropertyList

public String toGnuStepASCIIPropertyList()

Generates a valid ASCII property list in GnuStep format which has this NSArray as its root object. The generated property list complies with the format as described in GnuStep - NSPropertyListSerialization class documentation

Returns:

GnuStep ASCII representation of this object.

toASCII

protected void toASCII(StringBuilder ascii,
           int level)

Description copied from class: NSObject

Generates the ASCII representation of this object. The generated ASCII representation does not end with a newline. Complies with https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/PropertyLists/OldStylePlists/OldStylePLists.html

Specified by:

toASCII in class NSObject

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.

toASCIIGnuStep

protected void toASCIIGnuStep(StringBuilder ascii,
                  int level)

Description copied from class: NSObject

Generates the ASCII representation of this object in the GnuStep format. The generated ASCII representation does not end with a newline.

Specified by:

toASCIIGnuStep in class NSObject

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.