craterdog.collections.interfaces

Interface Dynamic<E>

Type Parameters:

E - The type of element managed by the collection.

All Known Implementing Classes:

Bag, Dictionary, List, Map, OpenCollection, OrderedCollection, Set, SortableCollection

public interface Dynamic<E>

This interface defines the methods that must be implemented by each collection that allows direct access to its elements.

Author:

Derk Norton

Method Summary

Modifier and Type	Method and Description
boolean	addElement(E element) This method adds a new element to the collection.
int	addElements(E[] elements) This method adds an array of new elements to the collection.
int	addElements(java.lang.Iterable<? extends E> elements) This method adds a list of new elements to the collection.
boolean	removeElement(E element) This method removes the specified element from the collection.
int	removeElements(E[] elements) This method removes the elements in the specified array from the collection.
int	removeElements(java.lang.Iterable<? extends E> elements) This method removes the specified elements from the collection.

Method Detail

addElement

boolean addElement(E element)

This method adds a new element to the collection. If the collection is empty then the new element will be the first element in the collection.

Parameters:

element - The new element to be added.

Returns:

Whether or not the element was actually added to the collection.

addElements

int addElements(E[] elements)

This method adds an array of new elements to the collection. The new elements will be added in the order they appear in the specified array.

Parameters:

elements - The array of new elements to be added.

Returns:

The number of elements that were actually added to the collection.

addElements

int addElements(java.lang.Iterable<? extends E> elements)

This method adds a list of new elements to the collection. The new elements will be added in the order they appear in the specified collection.

Parameters:

elements - The list of new elements to be added.

Returns:

The number of elements that were actually added to the collection.

removeElement

boolean removeElement(E element)

This method removes the specified element from the collection. If the element is not found in the collection, no changes are made.

Parameters:

element - The element to be removed.

Returns:

Whether or not the element was found.

removeElements

int removeElements(E[] elements)

This method removes the elements in the specified array from the collection. The number of matching elements is returned.

Parameters:

elements - The array of elements to be removed from the collection.

Returns:

The number of elements that were actually removed.

removeElements

int removeElements(java.lang.Iterable<? extends E> elements)

This method removes the specified elements from the collection. The number of matching elements is returned.

Parameters:

elements - The list of elements to be removed from the collection.

Returns:

The number of elements that were actually removed.