com.dd.plist

Class NSSet

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.NSSet

public class NSSet
extends NSObject

A set is an interface to an unordered collection of objects. This implementation uses a LinkedHashSet or TreeSetas the underlying data structure.

Warning: Sets cannot yet be used for saving in binary property lists, as binary property list format v1+ is required to save them.

Author:

Daniel Dreibrodt

See Also:

LinkedHashSet

Constructor Summary

Constructors

Constructor and Description
NSSet() Creates an empty unordered set.
NSSet(boolean ordered) Creates an empty set.
NSSet(boolean ordered, NSObject... objects) Create a set and fill it with the given objects.
NSSet(NSObject... objects) Create a set and fill it with the given objects.

Method Summary

Methods

Modifier and Type	Method and Description
void	addObject(NSObject obj) Adds an object to the set.
NSObject[]	allObjects() Returns all objects contained in the set.
NSObject	anyObject() Returns one of the objects in the set, or null if the set contains no objects.
boolean	containsObject(NSObject obj) Finds out whether a given object is contained in the set.
int	count() Gets the number of elements in the set.
boolean	equals(Object obj)
int	hashCode()
boolean	intersectsSet(NSSet otherSet) Finds out whether at least one object is present in both sets.
boolean	isSubsetOfSet(NSSet otherSet) Finds out if this set is a subset of the given set.
NSObject	member(NSObject obj) Determines whether the set contains an object equal to a given object and returns that object if it is present.
Iterator<NSObject>	objectIterator() Returns an iterator object that lets you iterate over all elements of the set.
void	removeObject(NSObject obj) Removes an object from the set.
protected void	toASCII(StringBuilder ascii, int level) Returns the ASCII representation of this set.
protected void	toASCIIGnuStep(StringBuilder ascii, int level) Returns the ASCII representation of this set according to the GnuStep format.

Methods inherited from class com.dd.plist.NSObject

toJavaObject, toXMLPropertyList, 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

NSSet

public NSSet()

Creates an empty unordered set.

See Also:

LinkedHashSet

NSSet

public NSSet(boolean ordered)

Creates an empty set.

Parameters:

ordered - Indicates whether the created set should be ordered or unordered.

See Also:

LinkedHashSet, TreeSet

NSSet

public NSSet(NSObject... objects)

Create a set and fill it with the given objects.

Parameters:

objects - The objects to populate the set.

See Also:

LinkedHashSet

NSSet

public NSSet(boolean ordered,
     NSObject... objects)

Create a set and fill it with the given objects.

Parameters:

objects - The objects to populate the set.

See Also:

LinkedHashSet, TreeSet

Method Detail

addObject

public void addObject(NSObject obj)

Adds an object to the set.

Parameters:

obj - The object to add.

removeObject

public void removeObject(NSObject obj)

Removes an object from the set.

Parameters:

obj - The object to remove.

allObjects

public NSObject[] allObjects()

Returns all objects contained in the set.

Returns:

An array of all objects in the set.

anyObject

public NSObject anyObject()

Returns one of the objects in the set, or null if the set contains no objects.

Returns:

The first object in the set, or null if the set is empty.

containsObject

public boolean containsObject(NSObject obj)

Finds out whether a given object is contained in the set.

Parameters:

obj - The object to look for.

Returns:

true, when the object was found, false otherwise.

member

public NSObject member(NSObject obj)

Determines whether the set contains an object equal to a given object and returns that object if it is present.

Parameters:

obj - The object to look for.

Returns:

The object if it is present, null otherwise.

intersectsSet

public boolean intersectsSet(NSSet otherSet)

Finds out whether at least one object is present in both sets.

Parameters:

otherSet - The other set.

Returns:

false if the intersection of both sets is empty, true otherwise.

isSubsetOfSet

public boolean isSubsetOfSet(NSSet otherSet)

Finds out if this set is a subset of the given set.

Parameters:

otherSet - The other set.

Returns:

true if all elements in this set are also present in the other set, false otherwise.

objectIterator

public Iterator<NSObject> objectIterator()

Returns an iterator object that lets you iterate over all elements of the set. This is the equivalent to objectEnumerator in the Cocoa implementation of NSSet.

Returns:

The iterator for the set.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

count

public int count()

Gets the number of elements in the set.

Returns:

The number of elements in the set.

See Also:

Set.size()

toASCII

protected void toASCII(StringBuilder ascii,
           int level)

Returns the ASCII representation of this set. There is no official ASCII representation for sets. In this implementation sets are represented as arrays.

Specified by:

toASCII in class NSObject

Parameters:

ascii -

level -

toASCIIGnuStep

protected void toASCIIGnuStep(StringBuilder ascii,
                  int level)

Returns the ASCII representation of this set according to the GnuStep format. There is no official ASCII representation for sets. In this implementation sets are represented as arrays.

Specified by:

toASCIIGnuStep in class NSObject

Parameters:

ascii -

level -