Java基础-Set接口源码

package java.util;

public interface Set<E> extends Collection<E> {
    // Query Operations

    /**
     * 返回集合中元素的数量，若大于Interger的最大值，则返回Interger的最大值。
     */
    int size();

    /**
     * 判断集合中是否包含元素，为空时返回true
     */
    boolean isEmpty();

    /**
     * 判断该集合是否包含指定元素，包含时返回true
     */
    boolean contains(Object o);

    /**
     * 返回该集合的迭代器
     */
    Iterator<E> iterator();

    /**
     * 返回一个包含该集合中所有元素的数组。如果该集合保证其迭代器返回元素的顺序，则此方法必须以相同的顺序返回元素
     */
    Object[] toArray();

    /**
     * 将此集合转换为数据返回
     */
    <T> T[] toArray(T[] a);

    /**
     * 向集合中添加一个元素
     */
    boolean add(E e);


    /**
     * 从集合中移除一个元素
     */
    boolean remove(Object o);


    // Bulk Operations

    /**
     * 该集合是否包含参数集合的所有元素
     */
    boolean containsAll(Collection<?> c);

    /**
     * 将参数集合中所有元素对象全部添加加当前集合中
     */
    boolean addAll(Collection<? extends E> c);

    /**
     * 保留两个集合共有的元素
     */
    boolean retainAll(Collection<?> c);

    /**
     * 从此集合中移除所有参数集合包含的元素
     */
    boolean removeAll(Collection<?> c);

    /**
     * 删除当前集合的所有元素
     */
    void clear();


    // Comparison and hashing

    /**
     * 判断该对象与目标对象的内容是否相等
     */
    boolean equals(Object o);

    /**
     * 返回该集合对象的哈希值
     */
    int hashCode();

    /**
     * 返回一个增强型迭代器对象
     */
    @Override
    default Spliterator<E> spliterator() {
        return Spliterators.spliterator(this, Spliterator.DISTINCT);
    }
}