Java Set集合

Interface Set

说明
参数类型
E - 由此集合维护的元素的类型
All Superinterfaces:
Collection ， Iterable
All Known Subinterfaces:
NavigableSet ， SortedSet

所有已知实现类：
AbstractSet ， ConcurrentHashMap.KeySetView ， ConcurrentSkipListSet ， CopyOnWriteArraySet ， EnumSet ， HashSet ， JobStateReasons ， LinkedHashSet ， TreeSet

public interface Set
extends Collection
不包含重复元素的集合。 更正式地，集合不包含一对元素e1和e2 ，使得e1.equals(e2) ，并且最多一个空元素。 正如其名称所暗示的那样，这个接口模拟了数学集抽象。

Set接口除了继承自Collection接口的所有构造函数的合同以及add,equals和hashCode方法的合同外 ， 还 增加了其他规定。 其他继承方法的声明也包括在这里以方便。 （伴随这些声明的规范已经量身定做Set接口，但它们不包含任何附加的规定。）

构造函数的额外规定并不奇怪，所有构造函数都必须创建一个不包含重复元素的集合（如上所定义）。

注意：如果可变对象用作设置元素，则必须非常小心。 如果对象的值以影响equals比较的方式更改，而对象是集合中的元素， 则不指定集合的行为。 这种禁止的一个特殊情况是，一个集合不允许将其本身作为一个元素。

一些集合实现对它们可能包含的元素有限制。 例如，一些实现禁止空元素，有些实现对元素的类型有限制。 尝试添加不合格元素会引发未经检查的异常，通常为NullPointerException或ClassCastException 。 尝试查询不合格元素的存在可能会引发异常，或者可能只是返回false; 一些实现将展现出前者的行为，一些实现将展现出后者。 更一般来说，尝试对不符合条件的元素的操作，其完成不会导致不合格元素插入到集合中，可能会导致异常，或者可能会成功执行该选项。 此异常在此接口的规范中标记为“可选”。

主要方法：

boolean	add(E e)

如果指定的元素不存在，则将其指定的元素添加（可选操作）。

boolean	addAll(Collection<? extends E> c)

将指定集合中的所有元素添加到此集合（如果尚未存在）（可选操作）。

void	clear()

从此集合中删除所有元素（可选操作）。

boolean	contains(Object o)

如果此集合包含指定的元素，则返回 true 。

boolean	containsAll(Collection<?> c)

返回 true如果此集合包含所有指定集合的元素。

boolean	equals(Object o)

将指定的对象与此集合进行比较以实现相等。

int	hashCode()

返回此集合的哈希码值。

boolean	isEmpty()

如果此集合不包含元素，则返回 true 。

Iterator<E>	iterator()

返回此集合中元素的迭代器。

boolean	remove(Object o)

如果存在，则从该集合中删除指定的元素（可选操作）。

boolean	removeAll(Collection<?> c)

从此集合中删除指定集合中包含的所有元素（可选操作）。

boolean	retainAll(Collection<?> c)

仅保留该集合中包含在指定集合中的元素（可选操作）。

int	size()

返回此集合中的元素数（其基数）。

default Spliterator<E>	spliterator()

在此集合中的元素上创建一个 Spliterator 。

Object[]	toArray()

返回一个包含此集合中所有元素的数组。

<T> T[]	toArray(T[] a)

返回一个包含此集合中所有元素的数组; 返回的数组的运行时类型是指定数组的运行时类型。

主要方法详解

size

int size()

返回此集合中的元素数（其基数）。
结果
该集合中的元素数（其基数）

isEmpty

boolean isEmpty()

如果此集合不包含元素，则返回 true 。
结果
true如果这个集合不包含元素

contains

boolean contains(Object o)

如果此集合包含指定的元素，则返回true 。
结果
true如果此集合包含指定的元素

add

boolean add(E e)

如果指定的元素不存在，则将其指定的元素添加（可选操作）。
结果
true如果此集合尚未包含指定的元素

remove

boolean remove(Object o)

如果存在，则从该集合中删除指定的元素（可选操作）。
结果
true如果这个集合包含指定的元素