All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface collections.Set

public interface interface Set
extends Collection
Sets provide an include operations for adding an element only if it is not already present. They also add a guarantee: With sets, you can be sure that the number of occurrences of any element is either zero or one.


Method Index

 o including(Object)
Construct a new Collection that is a clone of self except that it includes indicated element.

Methods

 o including
 public abstract Set including(Object element) throws IllegalElementException
Construct a new Collection that is a clone of self except that it includes indicated element. This can be used to create a series of collections, each differing from the other only in that they contain additional elements.

Parameters:
element - the element to include in the new collection
Returns:
a new collection c, with the sameStructure as this, except that c.includes(element)
Throws: IllegalElementException
if !canInclude(element)

All Packages  Class Hierarchy  This Package  Previous  Next  Index