模块  java.base
软件包  java.util.concurrent

Class ConcurrentSkipListSet<E>

    • 构造方法详细信息

      • ConcurrentSkipListSet

        public ConcurrentSkipListSet()
        构造一个新的空集,根据natural ordering对其元素进行排序
      • ConcurrentSkipListSet

        public ConcurrentSkipListSet​(Comparator<? super E> comparator)
        构造一个新的空集,根据指定的比较器对其元素进行排序。
        参数
        comparator - 将用于订购此集的比较器。 如果null ,将使用natural ordering的元素。
      • ConcurrentSkipListSet

        public ConcurrentSkipListSet​(SortedSet<E> s)
        构造一个包含相同元素的新集合,并使用与指定有序集合相同的顺序。
        参数
        s - 排序集,其元素将包含新集
        异常
        NullPointerException - 如果指定的有序集或其任何元素为null
    • 方法详细信息

      • clone

        public ConcurrentSkipListSet<E> clone()
        返回此ConcurrentSkipListSet实例的浅表副本。 (元素本身未被克隆。)
        重写:
        clone在类 Object
        结果
        这个集合的浅表副本
        另请参见:
        Cloneable
      • size

        public int size()
        返回此集合中的元素数。 如果此集包含超过Integer.MAX_VALUE元素,则返回Integer.MAX_VALUE

        请注意,与大多数集合不同,此方法不是恒定时间操作。 由于这些集合的异步性质,确定当前的元素数量需要遍历它们以计算它们。 另外,在执行此方法期间可能会更改大小,在这种情况下返回的结果将是不准确的。 因此,该方法在并发应用程序中通常不是很有用。

        Specified by:
        size在界面 Collection<E>
        Specified by:
        size在界面 Set<E>
        结果
        此集合中的元素数量
      • contains

        public boolean contains​(Object o)
        如果此set包含指定的元素,则返回true 更正式地,返回true当且仅当此集合包含e这样的元素o.equals(e)
        Specified by:
        contains在界面 Collection<E>
        Specified by:
        contains在界面 Set<E>
        重写:
        contains在课程 AbstractCollection<E>
        参数
        o - 要在此集中检查包含的对象
        结果
        true如果此set包含指定的元素
        异常
        ClassCastException - 如果指定的元素无法与此集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • add

        public boolean add​(E e)
        如果指定的元素尚不存在,则将其添加到此集合中。 更正式地,如果集合中不包含e2这样的e.equals(e2) ,则将指定的元素e添加到此集合中。 如果此set已包含该元素,则调用将保持set不变并返回false
        Specified by:
        add在界面 Collection<E>
        Specified by:
        add在界面 Set<E>
        重写:
        addAbstractCollection<E>
        参数
        e - 要添加到此集合的元素
        结果
        true如果此集合尚未包含指定的元素
        异常
        ClassCastException - 如果 e无法与此集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • remove

        public boolean remove​(Object o)
        如果存在,则从该集合中移除指定的元素。 更正式地,删除元素e ,使得o.equals(e) ,如果此集合包含这样的元素。 如果此set包含元素,则返回true (或等效地,如果此set因调用而更改)。 (一旦调用返回,该集合将不包含该元素。)
        Specified by:
        remove在界面 Collection<E>
        Specified by:
        remove在界面 Set<E>
        重写:
        removeAbstractCollection<E>
        参数
        o - 要从此集合中删除的对象(如果存在)
        结果
        true如果此set包含指定的元素
        异常
        ClassCastException - 如果 o无法与此集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • descendingIterator

        public Iterator<E> descendingIterator()
        以降序返回此集合中元素的迭代器。
        Specified by:
        descendingIterator ,界面 NavigableSet<E>
        结果
        这个集合中元素的迭代器按降序排列
      • equals

        public boolean equals​(Object o)
        将指定对象与此set进行相等性比较。 如果指定的对象也是一个集合,则返回true ,这两个集合具有相同的大小,并且指定集合的每个成员都包含在此集合中(或者等效地,此集合的每个成员都包含在指定的集合中)。 此定义确保equals方法在set接口的不同实现中正常工作。
        Specified by:
        equals在界面 Collection<E>
        Specified by:
        equals在界面 Set<E>
        重写:
        equalsAbstractSet<E>
        参数
        o - 要与此集进行相等性比较的对象
        结果
        true如果指定的对象等于此set
        另请参见:
        Object.hashCode()HashMap
      • lower

        public E lower​(E e)
        从界面复制的说明: NavigableSet
        返回此集合中的最大元素严格小于给定元素,如果没有这样的元素,则 null
        Specified by:
        lower在界面 NavigableSet<E>
        参数
        e - 要匹配的值
        结果
        e元素小于 e ,如果没有这样的元素 null
        异常
        ClassCastException - 如果指定的元素无法与集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • floor

        public E floor​(E e)
        从界面复制的说明: NavigableSet
        返回此set中小于或等于给定元素的最大元素,如果没有这样的元素,则 null
        Specified by:
        floor接口 NavigableSet<E>
        参数
        e - 要匹配的值
        结果
        e元素小于或等于 e ,如果没有这样的元素 null
        异常
        ClassCastException - 如果指定的元素无法与集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • ceiling

        public E ceiling​(E e)
        从界面复制的说明: NavigableSet
        返回此set中大于或等于给定元素的 null元素,如果没有这样的元素,则 null
        Specified by:
        ceiling在界面 NavigableSet<E>
        参数
        e - 要匹配的值
        结果
        最小元素大于或等于 e ,如果没有这样的元素, null
        异常
        ClassCastException - 如果指定的元素无法与集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • higher

        public E higher​(E e)
        从界面复制的说明: NavigableSet
        返回此集合中的最小元素严格大于给定元素,如果没有这样的元素,则 null
        Specified by:
        higher在界面 NavigableSet<E>
        参数
        e - 要匹配的值
        结果
        最小元素大于 e ,如果没有这样的元素 null
        异常
        ClassCastException - 如果指定的元素无法与集合中当前的元素进行比较
        NullPointerException - 如果指定的元素为null
      • first

        public E first()
        从界面复制的说明: SortedSet
        返回此集合中当前的第一个(最低)元素。
        Specified by:
        first ,界面 SortedSet<E>
        结果
        当前在此集合中的第一个(最低)元素
        异常
        NoSuchElementException - 如果此设置为空
      • last

        public E last()
        从界面复制的说明: SortedSet
        返回此集合中当前的最后一个(最高)元素。
        Specified by:
        last ,界面 SortedSet<E>
        结果
        当前在此集合中的最后一个(最高)元素
        异常
        NoSuchElementException - 如果此设置为空
      • subSet

        public NavigableSet<E> subSet​(E fromElement,
                                      boolean fromInclusive,
                                      E toElement,
                                      boolean toInclusive)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素范围为fromElementtoElement 如果fromElementtoElement相等,则返回的集合为空,除非fromInclusivetoInclusive都为真。 返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集合将尝试在其范围之外插入元素时抛出IllegalArgumentException

        Specified by:
        subSet ,界面 NavigableSet<E>
        参数
        fromElement - 返回集的低端点
        fromInclusive - true如果 true低端点包含在返回的视图中
        toElement - 返回集的高端点
        toInclusive - true如果 true高端点包含在返回的视图中
        结果
        此集合的部分视图,其元素范围从 fromElement (含),到 toElement ,独占
        异常
        ClassCastException - 如果fromElementtoElement无法使用此组的比较器相互比较(或者,如果该组没有比较器,则使用自然排序)。 如果无法将fromElementtoElement与当前集合中的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromElementtoElement为空
        IllegalArgumentException - 如果fromElement大于toElement ; 或者如果此设置本身具有受限范围,则fromElementtoElement位于范围的范围之外。
      • headSet

        public NavigableSet<E> headSet​(E toElement,
                                       boolean inclusive)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素小于(或等于,如果inclusive为true) toElement 返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集合将尝试在其范围之外插入元素时抛出IllegalArgumentException

        Specified by:
        headSet ,界面 NavigableSet<E>
        参数
        toElement - 返回集的高端点
        inclusive - true如果 true高端点包含在返回的视图中
        结果
        该集合的部分视图,其元素小于(或等于,如果 inclusive为真) toElement
        异常
        ClassCastException - 如果toElement与该组的比较器不兼容(或者,如果该组没有比较器,如果toElement未实现Comparable )。 如果无法将toElement与当前集合中的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 toElement为空
        IllegalArgumentException - 如果此设置本身具有受限范围,并且 toElement位于范围的范围之外
      • tailSet

        public NavigableSet<E> tailSet​(E fromElement,
                                       boolean inclusive)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素大于(或等于,如果inclusive为true) fromElement 返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集合将尝试在其范围之外插入元素时抛出IllegalArgumentException

        Specified by:
        tailSet in interface NavigableSet<E>
        参数
        fromElement - 返回集的低端点
        inclusive - true如果 true低端点包含在返回的视图中
        结果
        该集合的部分视图,其元素大于或等于 fromElement
        异常
        ClassCastException - 如果fromElement与该组的比较器不兼容(或者,如果该组没有比较器,如果fromElement未实现Comparable )。 如果fromElement无法与集合中当前的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromElement为空
        IllegalArgumentException - 如果此设置本身具有受限范围,并且 fromElement位于范围的范围之外
      • subSet

        public NavigableSet<E> subSet​(E fromElement,
                                      E toElement)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素范围从fromElement (含)到toElement (不包括)。 (如果fromElementtoElement相等,则返回的集合为空。)返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集合将尝试在其范围之外插入元素时抛出IllegalArgumentException

        相当于subSet(fromElement, true, toElement, false)

        Specified by:
        subSet ,界面 NavigableSet<E>
        Specified by:
        subSet接口 SortedSet<E>
        参数
        fromElement - 返回集的低端点(包括)
        toElement - 返回集的高端点(不包括)
        结果
        此集合的部分视图,其元素范围从 fromElement (含)到 toElement ,独占
        异常
        ClassCastException - 如果fromElementtoElement无法使用此组的比较器相互比较(或者,如果该组没有比较器,则使用自然排序)。 如果无法将fromElementtoElement与当前集合中的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromElementtoElement为空
        IllegalArgumentException - 如果fromElement大于toElement ; 或者如果此设置本身具有受限范围,并且fromElementtoElement位于范围的范围之外
      • headSet

        public NavigableSet<E> headSet​(E toElement)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素严格小于toElement 返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集将在尝试插入超出其范围的元素时抛出IllegalArgumentException

        相当于headSet(toElement, false)

        Specified by:
        headSet在界面 NavigableSet<E>
        Specified by:
        headSet在界面 SortedSet<E>
        参数
        toElement - 返回集的高端点(不包括)
        结果
        该集合的部分视图,其元素严格小于 toElement
        异常
        ClassCastException - 如果toElement与该组的比较器不兼容(或者,如果该组没有比较器,则toElement未实现Comparable )。 如果无法将toElement与当前集合中的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 toElement为空
        IllegalArgumentException - 如果此设置本身具有受限范围,并且 toElement位于范围的范围之外
      • tailSet

        public NavigableSet<E> tailSet​(E fromElement)
        从界面复制的说明: NavigableSet
        返回此set的部分视图,其元素大于或等于fromElement 返回的集由此集支持,因此返回集中的更改将反映在此集中,反之亦然。 返回的集支持此集支持的所有可选集操作。

        返回的集合将尝试在其范围之外插入元素时抛出IllegalArgumentException

        相当于tailSet(fromElement, true)

        Specified by:
        tailSet在界面 NavigableSet<E>
        Specified by:
        tailSet在界面 SortedSet<E>
        参数
        fromElement - 返回集的低端点(包括)
        结果
        该组的部分视图,其元素大于或等于 fromElement
        异常
        ClassCastException - 如果fromElement与该组的比较器不兼容(或者,如果该组没有比较器,如果fromElement未实现Comparable )。 如果无法将fromElement与当前集合中的元素进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromElement为空
        IllegalArgumentException - 如果此设置本身具有受限范围,并且 fromElement位于范围的范围之外
      • descendingSet

        public NavigableSet<E> descendingSet()
        返回此set中包含的元素的逆序视图。 降序集由此集支持,因此对集的更改将反映在降序集中,反之亦然。

        返回的集合的订货量等于Collections.reverseOrder (comparator()) 表达s.descendingSet().descendingSet()返回一个视图的s实质上等同于s

        Specified by:
        descendingSet接口 NavigableSet<E>
        结果
        该集的逆序视图