Skip navigation links

com.sigmadynamics.sdo.support
Class SDChoiceArray

java.lang.Object
com.sigmadynamics.util.SDArray
com.sigmadynamics.sdo.support.SDChoiceArray

All Implemented Interfaces:

ChoiceArrayInterface

public class SDChoiceArray

extends SDArray

implements ChoiceArrayInterface

Type safe implementation of resizable array containing elements of type Choice.

See Also:

Serialized Form

Field Summary

protected Choice[]	buf
(package private) boolean	needsRehashing
(package private) java.util.HashSet<Choice>	set

Fields inherited from class com.sigmadynamics.util.SDArray

ALLOC_UNIT, DEFAULT_INITIAL_SIZE, size

Constructor Summary

SDChoiceArray()
Constructs an empty array.

SDChoiceArray(int capacity)
Constructs an empty array with the specified initial capacity.

Method Summary

void	add(Choice element) Appends the specified element to the end of this array.
void	add(ChoiceInterface element) Appends the specified ChoiceInterface to the end of this array.
void	addAll(ChoiceArrayInterface array) Appends all of the elements in the specified array to the end of this array.
void	addAll(SDChoiceArray array) Appends all of the elements in the specified array to the end of this array.
int	capacity() Returns buffer capacity.
boolean	contains(Choice element) Returns true if this array contains the specified element.
boolean	contains(ChoiceInterface val) Returns true if this array contains the specified element.
boolean	containsAll(ChoiceArrayInterface sdArr) Returns true if this array contains all elements of the specified array.
boolean	containsAll(SDChoiceArray elements) Returns true if this array contains all elements of the specified array.
boolean	containsAny(ChoiceArrayInterface sdArr) Returns true if this array contains any one of the elements of the specified array.
boolean	containsAny(SDChoiceArray elements) Returns true if this array contains any one of the elements of the specified array.
protected void	ensureCapacity(int capacity) Grows the internal buffer as needed to accomodate the specified number of elements.
boolean	equals(java.lang.Object anObject) Element by element comparison.
void	fill(Choice element) Replaces all elements of this array with the same value.
void	fill(int fromIndex, int toIndex, Choice element) Replaces a group of consequtive elements of this array with the same value.
Choice	get(int index) Returns the element at the specified position in this array.
ChoiceInterface	getChoiceInterface(int index) Returns the element at the specified position in this array.
static int	indexOf(Choice element, Choice[] array) Returns the index in an array of the first occurence of the specified element, or -1 if the array does not contain such element.
void	set(int index, Choice element) Replaces the element at the specified position in this array with the specified element.
void	setSize(int size) Adds or deletes elements at the end of the array.
void	sort() Sorts the array in ascending order.
void	sort(java.util.Comparator<Choice> c) Sorts the array of objects according to the order induced by the specified comparator.
Choice[]	toArray() Returns an array of Choice containing all elements of this one.
void	toArray(Choice[] array) Copies elements to a given array.
java.lang.String	toString() Returns a string representation of this array.
void	trimToSize() Removes any excess buffer capacity above the actual number of elements.

Methods inherited from class com.sigmadynamics.util.SDArray

clear, isEmpty, rangeCheck, size

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.sigmadynamics.sdo.interfaces.client.ChoiceArrayInterface

clear, size

Field Detail

buf

protected Choice[] buf

needsRehashing

boolean needsRehashing

set

java.util.HashSet<Choice> set

Constructor Detail

SDChoiceArray

public SDChoiceArray()

Constructs an empty array.

SDChoiceArray

public SDChoiceArray(int capacity)

Constructs an empty array with the specified initial capacity.

Parameters:

capacity - the initial capacity of the array.

Method Detail

capacity

public int capacity()

Returns buffer capacity.

Specified by:

capacity in class SDArray

Returns:

buffer capacity.

get

public Choice get(int index)

Returns the element at the specified position in this array.

Parameters:

index - index of the element to return.

Returns:

The element at the specified position in this array.

set

public void set(int index,
                Choice element)

Replaces the element at the specified position in this array with the specified element.

Parameters:

index - index of the element to replace.

element - element to be stored at the specified position.

add

public void add(Choice element)

Appends the specified element to the end of this array.

Parameters:

element - element to be appended to this array.

addAll

public void addAll(SDChoiceArray array)

Appends all of the elements in the specified array to the end of this array.

Parameters:

array - array containing elements to be appended to this array.

fill

public void fill(Choice element)

Replaces all elements of this array with the same value.

Parameters:

element - element that replaces all elements of this array.

fill

public void fill(int fromIndex,
                 int toIndex,
                 Choice element)

Replaces a group of consequtive elements of this array with the same value. The group of elements to be replaced consists of elements whose index is between fromIndex, inclusive, and toIndex, exclusive.

Parameters:

fromIndex - index of the first element to be replaced.

toIndex - index after the last element to be replaced.

element - element that replaces the elements from fromIndex to toIndex.

contains

public boolean contains(Choice element)

Returns true if this array contains the specified element.

Parameters:

element - element whose presence in this array is to be tested.

Returns:

true if the specified element is present; false otherwise.

containsAll

public boolean containsAll(SDChoiceArray elements)

Returns true if this array contains all elements of the specified array.

Parameters:

elements - elements whose presence in this array is to be tested.

Returns:

true if all specified elements is present in this array; false otherwise.

containsAny

public boolean containsAny(SDChoiceArray elements)

Returns true if this array contains any one of the elements of the specified array.

Parameters:

elements - elements whose presence in this array is to be tested.

Returns:

true if any specified elements are present in this array; false otherwise.

sort

public void sort()

Sorts the array in ascending order.

Throws:

java.lang.ClassCastException - if the array elements do not implement Comparable interface.

See Also:

Comparable

sort

public void sort(java.util.Comparator<Choice> c)

Sorts the array of objects according to the order induced by the specified comparator.

Parameters:

c - the comparator to determine the order of the array. A null value indicates that the natural ordering of the elements should be used.

Throws:

java.lang.ClassCastException - if the array contains elements that are not mutually comparable using the specified comparator.

See Also:

Comparator

equals

public boolean equals(java.lang.Object anObject)

Element by element comparison.

Overrides:

equals in class java.lang.Object

Parameters:

anObject - an object to compare this array with.

Returns:

true if the arrays are equal, false otherwise.

toArray

public Choice[] toArray()

Returns an array of Choice containing all elements of this one.

Returns:

an array of Choice containing all elements of this one.

toArray

public void toArray(Choice[] array)

Copies elements to a given array. If the supplied array is shorter than the number of elements in this one, only the elements that fit the supplied array are copied. If the supplied array is longer than the number of elements in this one, the rear part of the supplied array remains unchanged.

Parameters:

array - the array to which the elements of this one are to be copied.

Throws:

java.lang.ArrayStoreException - if the runtime type of the supplied array is not a supertype of the runtime type of every element in this one.

setSize

public void setSize(int size)

Adds or deletes elements at the end of the array.

Specified by:

setSize in class SDArray

Parameters:

size - new number or elements.

Throws:

java.lang.IllegalArgumentException - if size < 0.

trimToSize

public void trimToSize()

Removes any excess buffer capacity above the actual number of elements.

Specified by:

trimToSize in class SDArray

toString

public java.lang.String toString()

Returns a string representation of this array. The string representation consists of elements of the array enclosed in square brackets ("[]"). Adjacent elements are separated by the characters ", " (comma and space). Elements are converted to strings by String.valueOf(Object).

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this array.

indexOf

public static int indexOf(Choice element,
                          Choice[] array)

Returns the index in an array of the first occurence of the specified element, or -1 if the array does not contain such element. This method uses linear search.

ensureCapacity

protected void ensureCapacity(int capacity)

Grows the internal buffer as needed to accomodate the specified number of elements.

Specified by:

ensureCapacity in class SDArray

Parameters:

capacity - number of elements to accomodate.

getChoiceInterface

public ChoiceInterface getChoiceInterface(int index)

Returns the element at the specified position in this array.

Specified by:

getChoiceInterface in interface ChoiceArrayInterface

Parameters:

index - index of the element to return.

Returns:

The ChoiceInterface at the specified position in this array.

add

public void add(ChoiceInterface element)

Appends the specified ChoiceInterface to the end of this array.

Specified by:

add in interface ChoiceArrayInterface

Parameters:

element - ChoiceInterface to be appended to this array.

addAll

public void addAll(ChoiceArrayInterface array)

Appends all of the elements in the specified array to the end of this array.

Specified by:

addAll in interface ChoiceArrayInterface

Parameters:

array - ChoiceArrayInterface containing ChoiceInterface elements to be appended to this array.

contains

public boolean contains(ChoiceInterface val)

Returns true if this array contains the specified element.

Specified by:

contains in interface ChoiceArrayInterface

Parameters:

val - element whose presence in this array is to be tested.

Returns:

true if the specified element is present; false otherwise.

containsAll

public boolean containsAll(ChoiceArrayInterface sdArr)

Returns true if this array contains all elements of the specified array.

Specified by:

containsAll in interface ChoiceArrayInterface

Parameters:

sdArr - elements whose presence in this array is to be tested.

Returns:

true if all specified elements is present in this array; false otherwise.

containsAny

public boolean containsAny(ChoiceArrayInterface sdArr)

Returns true if this array contains any one of the elements of the specified array.

Specified by:

containsAny in interface ChoiceArrayInterface

Parameters:

sdArr - elements whose presence in this array is to be tested.

Returns:

true if any specified elements are present in this array; false otherwise.

Skip navigation links