myUtil

Interface Set<T>

All Superinterfaces:

java.lang.Iterable<T>

public interface Set<T>
extends java.lang.Iterable<T>

Author:

Chung-Chih Li 11/8/2013 modified

Method Summary

Modifier and Type	Method and Description
void	add(Set<T> S) Add every element in Set S into this Set.
void	add(T e) Add e into this Set.
boolean	contains(Set<T> S) Subset.
Set<T>	diff(Set<T> S) Difference.
boolean	equals(java.lang.Object o) Standard equals method.
boolean	has(T e) Membership.
Set<T>	intersect(Set<T> S) Intersection.
boolean	isEmpty() Check empty.
void	remove(Set<T> S) Remove every element in Set S from this Set.
void	remove(T e) Remove e from this Set.
T	removeOne() Remove and return the first element from this Set, where the meaning of "first" is open to the implementation.
int	size() Cardinality (size) of this Set
java.lang.Object[]	toArray() Standard toArray() method.
T[]	toArray(T[] a) Standard toArray() method with array parameter
java.lang.String	toString() Standard toString method.
Set<T>	union(Set<T> S) Union.

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Method Detail

size

int size()

Cardinality (size) of this Set

Returns:

the size of this Set

isEmpty

boolean isEmpty()

Check empty.

Returns:

true if this Set is empty, false otherwise.

intersect

Set<T> intersect(Set<T> S)

Intersection.

Parameters:

S - another Set of T

Returns:

the intersection of this Set and S.

union

Set<T> union(Set<T> S)

Union.

Parameters:

S - another Set of T

Returns:

the union of this Set and S.

diff

Set<T> diff(Set<T> S)

Difference.

Parameters:

S - another Set of T

Returns:

this Set minus S.

has

boolean has(T e)

Membership.

Parameters:

e - is a T

Returns:

true if e is in this Set, false otherwise.

contains

boolean contains(Set<T> S)

Subset.

Parameters:

S - is Set of T

Returns:

true if S is contained in this Set, false otherwise.

add

void add(T e)

Add e into this Set.

Parameters:

e - is a T.

add

void add(Set<T> S)

Add every element in Set S into this Set.

Parameters:

S - is a Set of T.

removeOne

T removeOne()

Remove and return the first element from this Set, where the meaning of "first" is open to the implementation.

Returns:

the element that is removed

remove

void remove(T e)

Remove e from this Set.

Parameters:

e - is a T

remove

void remove(Set<T> S)

Remove every element in Set S from this Set.

Parameters:

S - is a Set of T

toArray

java.lang.Object[] toArray()

Standard toArray() method.

Returns:

an array that contains all elements of this Set.

toArray

T[] toArray(T[] a)

Standard toArray() method with array parameter

Parameters:

a - if a's size is big enough, use a, otherwise new a sufficient array.

Returns:

Return an array of the same type that contains all elements of this Set

Throws:

java.lang.NullPointerException - will be thrown if a is null.

toString

java.lang.String toString()

Standard toString method.

Overrides:

toString in class java.lang.Object

Returns:

the representation of this Set in a String as "{e1,e2,...}" where e1,e2,... are the returned String of toString() of each element.

equals

boolean equals(java.lang.Object o)

Standard equals method.

Overrides:

equals in class java.lang.Object

Parameters:

o - is the object to be compared

Returns:

true if o is the same set as this Set.