クラスConcurrentSkipListSet<E>

java.lang.Object
java.util.AbstractCollection<E>
java.util.AbstractSet<E>
java.util.concurrent.ConcurrentSkipListSet<E>
型パラメータ:
E - このセットによって保守される要素のタイプ
すべての実装されたインタフェース:
Serializable, Cloneable, Iterable<E>, Collection<E>, NavigableSet<E>, SequencedCollection<E>, SequencedSet<E>, Set<E>, SortedSet<E>
public class ConcurrentSkipListSet<E> extends AbstractSet<E> implements NavigableSet<E>, Cloneable, Serializable
ConcurrentSkipListMapに基づくスケーラブルな並行NavigableSet実装です。 セットの要素は、どのコンストラクタが使用されているかに応じて、その自然順序付けに従って、またはセット作成時に提供されるComparatorによってソートされます。

この実装は、contains、add、およびremoveオペレーションとそれらのバリアントに予想される平均log(n)時間コストを提供します。 挿入、削除、アクセスの各オペレーションは、複数のスレッドによって並行して、安全に実行されます。

イテレータおよびスプリッテレータは弱一貫性を持っています。

昇順で並べられたビューとそのイテレータは、降順の場合よりも高速になります。

大半のコレクションとは異なり、sizeメソッドは一定時間のオペレーションではないことに留意してください。 これらのセットには非同期という特性があるため、現在の要素数を判定するには要素のトラバーサルが必要になります。そのため、このコレクションがトラバーサル中に変更された場合は、不正確な結果が報告される可能性があります。

AbstractCollection.addAll(Collection)、Collection.removeIf(Predicate)、Iterable.forEach(Consumer)などの複数の要素を追加、削除、または検査するバルク操作は、原子的に実行されることは保証されていません。 たとえば、 addAll操作と並行するforEachトラバースでは、追加された要素の一部のみが監視される場合があります。

このクラスとそのイテレータは、SetおよびIteratorインタフェースのすべてのオプション・メソッドを実装します。 他のほとんどの並行処理コレクションの実装と同様、このクラスはnull要素の使用を許可しません。これは、nullの引数と戻り値は要素がない場合と確実に区別できないためです。

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:
1.6
関連項目:

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    ConcurrentSkipListSet()
    自然順序付けに従って要素を順序付けする、新しい空のセットを作成します。
    ConcurrentSkipListSet(Collection<? extends E> c)
    指定されたコレクション内の要素を持ち、要素をその自然順序付けに従って順序付けする新しいセットを作成します。
    ConcurrentSkipListSet(Comparator<? super E> comparator)
    指定されたコンパレータに従って要素の順序付けを行う、新しい空のセットを作成します。
    ConcurrentSkipListSet(SortedSet<E> s)
    指定されたソート・セットと同じ要素を持ち、同じ順序付けを使用する、新しいセットを構築します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    boolean
    add(E e)
    指定された要素がセットの要素として存在しない場合に、その要素をセットに追加します。
    void
    addFirst(E e)
    UnsupportedOperationExceptionをスローします。
    void
    addLast(E e)
    UnsupportedOperationExceptionをスローします。
    E
    ceiling(E e)
    このセット内で、指定された要素と等しいかそれよりも大きい要素の中で最小のものを返します。そのような要素が存在しない場合はnullを返します。
    void
    clear()
    すべての要素をセットから削除します。
    ConcurrentSkipListSet<E>
    clone()
    ConcurrentSkipListSetのインスタンスのシャロー・コピーを返します。
    Comparator<? super E>
    comparator()
    このセットの要素の順序付けに使用されるコンパレータを返します。このセットが要素の「自然順序付け」を使用する場合はnullを返します。
    boolean
    contains(Object o)
    指定された要素がこのセットに含まれている場合にtrueを返します。
    Iterator<E>
    descendingIterator()
    このセットの要素のイテレータを降順で返します。
    NavigableSet<E>
    descendingSet()
    このセットに含まれる要素の逆順のビューを返します。
    boolean
    equals(Object o)
    指定されたオブジェクトがセットと同じかどうかを比較します。
    E
    first()
    セット内に現在ある最初(下端)の要素を返します。
    E
    floor(E e)
    このセット内で、指定された要素と等しいかそれよりも小さい要素の中で最大のものを返します。そのような要素が存在しない場合はnullを返します。
    NavigableSet<E>
    headSet(E toElement)
    このセットの要素がtoElementより厳密に小さい部分のビューを返します。
    NavigableSet<E>
    headSet(E toElement, boolean inclusive)
    このセットのtoElementよりも小さい要素(inclusiveがtrueの場合はそれよりも小さいかそれと等しい要素)を含む部分のビューを返します。
    E
    higher(E e)
    このセット内で、指定された要素よりも確実に大きい要素の中で最小のものを返します。そのような要素が存在しない場合はnullを返します。
    boolean
    isEmpty()
    このセットに要素が1つも含まれていない場合にtrueを返します。
    Iterator<E>
    iterator()
    このセットの要素のイテレータを昇順で返します。
    E
    last()
    セット内に現在ある最後(上端)の要素を返します。
    E
    lower(E e)
    このセット内で、指定された要素よりも確実に小さい要素の中で最大のものを返します。そのような要素が存在しない場合はnullを返します。
    E
    pollFirst()
    最初の(最低)要素を取得して削除するか、このセットが空の(オプションの操作)の場合はnullを返します。
    E
    pollLast()
    最後の(最高)要素を取得して削除するか、このセットが空の(オプションの操作)の場合はnullを返します。
    boolean
    remove(Object o)
    指定された要素がこのセットに存在する場合に、要素をセットから削除します。
    boolean
    removeAll(Collection<?> c)
    セットから、指定されたコレクション内に保持されているすべての要素を削除します。
    int
    size()
    このセット中の要素の数を返します。
    Spliterator<E>
    spliterator()
    このセット内の要素に対するSpliteratorを返します。
    NavigableSet<E>
    subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
    このセットのfromElement - toElementの要素範囲を持つ部分のビューを返します。
    NavigableSet<E>
    subSet(E fromElement, E toElement)
    このセットの要素の範囲がfromElement、包含的、排他的、toElementである部分のビューを返します。
    NavigableSet<E>
    tailSet(E fromElement)
    要素がfromElement以上である、このセットの一部のビューを返します。
    NavigableSet<E>
    tailSet(E fromElement, boolean inclusive)
    このセットのfromElementよりも大きい要素(inclusiveがtrueの場合はそれよりも大きいかそれと等しい要素)を含む部分のビューを返します。

    クラスで宣言されたメソッド AbstractSet

    hashCode
    修飾子と型
    メソッド
    説明
    int
    hashCode()
    セットのハッシュ・コード値を返します。

    クラスで宣言されたメソッド AbstractCollection

    addAll, containsAll, retainAll, toArray, toArray, toString
    修飾子と型
    メソッド
    説明
    boolean
    addAll(Collection<? extends E> c)
    指定されたコレクションのすべての要素をこのコレクションに追加します(オプションの操作)。
    boolean
    containsAll(Collection<?> c)
    指定したコレクションのすべての要素がこのコレクションに含まれている場合、trueを返します。
    boolean
    retainAll(Collection<?> c)
    このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。
    Object[]
    toArray()
    このコレクションの要素がすべて格納されている配列を返します。
    <T> T[]
    toArray(T[] a)
    このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。
    String
    toString()
    このコレクションの文字列表現を返します。

    クラスオブジェクトで宣言されたメソッド

    finalize, getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

    インタフェースCollectionで宣言されたメソッド

    parallelStream, removeIf, stream, toArray
    修飾子と型
    メソッド
    説明
    default Stream<E>
    parallelStream()
    このコレクションをソースとして、潜在的に並列のStreamを返します。
    default boolean
    removeIf(Predicate<? super E> filter)
    指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。
    default Stream<E>
    stream()
    このコレクションをソースとして使用して、逐次的なStreamを返します。
    default <T> T[]
    toArray(IntFunction<T[]> generator)
    指定されたgenerator関数を使用してこのコレクションのすべての要素を含む配列を返し、返された配列を割り当てます。

    インタフェースIterableで宣言されたメソッド

    forEach
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer<? super E> action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。

    インタフェースで宣言されたメソッド NavigableSet

    removeFirst, removeLast, reversed
    修飾子と型
    メソッド
    説明
    default E
    removeFirst()
    このコレクションの最初の要素を削除して返します(オプションの操作)。
    default E
    removeLast()
    このコレクションの最後の要素を削除して返します(オプションの操作)。
    default NavigableSet<E>
    reversed()
    このコレクションの逆順viewを返します。

    インタフェースSetで宣言されたメソッド

    addAll, containsAll, retainAll, toArray, toArray
    修飾子と型
    メソッド
    説明
    boolean
    addAll(Collection<? extends E> c)
    指定されたコレクションのすべての要素について、その要素がこのセット内にない場合、セットに追加します(オプションの操作)。
    boolean
    containsAll(Collection<?> c)
    指定されたコレクションのすべての要素がこのセットに含まれている場合にtrueを返します。
    boolean
    retainAll(Collection<?> c)
    セット内の要素のうち、指定されたコレクション内にある要素だけを保持します(オプションの操作)。
    Object[]
    toArray()
    セット内のすべての要素が格納されている配列を返します。
    <T> T[]
    toArray(T[] a)
    セット内のすべての要素を格納している配列を返します。返される配列の実行時の型は、指定された配列の型になります。

    インタフェースで宣言されたメソッド SortedSet

    getFirst, getLast
    修飾子と型
    メソッド
    説明
    default E
    getFirst()
    このコレクションの最初の要素を取得します。
    default E
    getLast()
    このコレクションの最後の要素を取得します。

  • コンストラクタの詳細

    • ConcurrentSkipListSet

      public ConcurrentSkipListSet()
      自然順序付けに従って要素を順序付けする、新しい空のセットを作成します。

    • ConcurrentSkipListSet

      public ConcurrentSkipListSet(Comparator<? super E> comparator)
      指定されたコンパレータに従って要素の順序付けを行う、新しい空のセットを作成します。
      パラメータ:
      comparator - このセットの順序付けを行うために使用されるコンパレータ。 nullの場合、要素の自然順序付けが使用される。

    • ConcurrentSkipListSet

      public ConcurrentSkipListSet(Collection<? extends E> c)
      指定されたコレクション内の要素を持ち、要素をその自然順序付けに従って順序付けする新しいセットを作成します。
      パラメータ:
      c - 新しいセットを構成する要素
      スロー:
      ClassCastException - c内の要素がComparableでないか、または相互に比較可能でない場合
      NullPointerException - 指定されたコレクションまたはそのいずれかの要素がnullである場合

    • ConcurrentSkipListSet

      public ConcurrentSkipListSet(SortedSet<E> s)
      指定されたソート・セットと同じ要素を持ち、同じ順序付けを使用する、新しいセットを構築します。
      パラメータ:
      s - 新しいセットを構成する要素からなるソート・セット
      スロー:
      NullPointerException - 指定されたソート・セット、またはその要素のいずれかがnullの場合

  • メソッドの詳細

    • clone

      public ConcurrentSkipListSet<E> clone()
      ConcurrentSkipListSetのインスタンスのシャロー・コピーを返します。 (要素自体は複製されません。)
      オーバーライド:
      clone、クラスObject
      戻り値:
      このセットのシャロー・コピー
      関連項目:

    • size

      public int size()
      このセット中の要素の数を返します。 このセットにInteger.MAX_VALUEを超える要素が含まれている場合は、Integer.MAX_VALUEを返します。

      このメソッドの実行中にサイズが変更される可能性があり、その場合、返される結果は不正確になります。 そのため、このメソッドは、通常は並行処理アプリケーションではあまり便利ではありません。

      定義:
      size、インタフェースCollection<E>
      定義:
      size、インタフェースSet<E>
      戻り値:
      セットの要素数

    • isEmpty

      public boolean isEmpty()
      このセットに要素が1つも含まれていない場合にtrueを返します。
      定義:
      isEmpty、インタフェースCollection<E>
      定義:
      isEmpty、インタフェースSet<E>
      オーバーライド:
      isEmpty、クラスAbstractCollection<E>
      戻り値:
      セットに要素がない場合はtrue

    • contains

      public boolean contains(Object o)
      指定された要素がこのセットに含まれている場合にtrueを返します。 つまり、このセットにo.equals(e)となる要素eが含まれている場合にだけtrueを返します。
      定義:
      contains、インタフェースCollection<E>
      定義:
      contains、インタフェースSet<E>
      オーバーライド:
      contains、クラスAbstractCollection<E>
      パラメータ:
      o - このセットに含まれているかどうかがチェックされるオブジェクト
      戻り値:
      指定された要素がこのセットに含まれている場合はtrue
      スロー:
      ClassCastException - 指定された要素がこのセット内に現在ある要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • add

      public boolean add(E e)
      指定された要素がセットの要素として存在しない場合に、その要素をセットに追加します。 つまり、このセットにe.equals(e2)となる要素e2が含まれていない場合は、指定された要素eをこのセットに追加します。 このセット内にすでにその要素が含まれている場合、この呼出しはセットを変更せずにfalseを返します。
      定義:
      add、インタフェースCollection<E>
      定義:
      add、インタフェースSet<E>
      オーバーライド:
      add、クラスAbstractCollection<E>
      パラメータ:
      e - このセットに追加される要素
      戻り値:
      このセット内に、指定された要素がなかった場合はtrue
      スロー:
      ClassCastException - eが現在このセット内にある要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • remove

      public boolean remove(Object o)
      指定された要素がこのセットに存在する場合に、要素をセットから削除します。 つまり、このセットにo.equals(e)となる要素eが含まれている場合は、そのような要素を削除します。 その要素がこのセットに含まれていた場合、つまり、呼出しの結果としてこのセットが変更された場合はtrueを返します。 呼出しが復帰したあとは、このセットはその要素を持っていません。
      定義:
      remove、インタフェースCollection<E>
      定義:
      remove、インタフェースSet<E>
      オーバーライド:
      remove、クラスAbstractCollection<E>
      パラメータ:
      o - このセットから削除されるオブジェクト(そのオブジェクトが存在する場合)
      戻り値:
      指定された要素がこのセットに含まれていた場合はtrue
      スロー:
      ClassCastException - oが現在このセット内にある要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • clear

      public void clear()
      すべての要素をセットから削除します。
      定義:
      clear、インタフェースCollection<E>
      定義:
      clear、インタフェースSet<E>
      オーバーライド:
      clear、クラスAbstractCollection<E>

    • iterator

      public Iterator<E> iterator()
      このセットの要素のイテレータを昇順で返します。
      定義:
      iterator、インタフェースCollection<E>
      定義:
      iterator、インタフェースIterable<E>
      定義:
      iterator、インタフェースNavigableSet<E>
      定義:
      iterator、インタフェースSet<E>
      定義:
      iterator、クラスAbstractCollection<E>
      戻り値:
      昇順の、このセットの要素のイテレータ

    • descendingIterator

      public Iterator<E> descendingIterator()
      このセットの要素のイテレータを降順で返します。
      定義:
      descendingIterator、インタフェースNavigableSet<E>
      戻り値:
      降順の、このセットの要素のイテレータ

    • equals

      public boolean equals(Object o)
      指定されたオブジェクトがセットと同じかどうかを比較します。 指定されたオブジェクトもセットで、2つのセットが同じサイズを持ち、指定されたセットのすべてのメンバーがこのセットに含まれる場合(つまり、このセットのすべてのメンバーが指定されたセットに含まれる場合)にtrueを返します。 この定義により、equalsメソッドがセット・インタフェースのさまざまな実装で適切に動作することが保証されます。
      定義:
      equals、インタフェースCollection<E>
      定義:
      equals、インタフェースSet<E>
      オーバーライド:
      equals、クラスAbstractSet<E>
      パラメータ:
      o - このセットと等しいかどうかを比較するオブジェクト
      戻り値:
      指定されたオブジェクトがこのセットに等しい場合はtrue
      関連項目:

    • removeAll

      public boolean removeAll(Collection<?> c)
      セットから、指定されたコレクション内に保持されているすべての要素を削除します。 指定されたコレクションもセットである場合、このオペレーションは、その値が2つのセットの非対称集合差分になるようにこのセットを効率的に変更します。
      定義:
      removeAll、インタフェースCollection<E>
      定義:
      removeAll、インタフェースSet<E>
      オーバーライド:
      removeAll、クラスAbstractSet<E>
      パラメータ:
      c - このセットから削除される要素を含むコレクション
      戻り値:
      呼出しの結果としてこのセットが変更された場合はtrue
      スロー:
      ClassCastException - このセットのある要素のクラスが、指定されたコレクションと互換でない場合(オプション)
      NullPointerException - 指定されたコレクションまたはそのいずれかの要素がnullである場合
      関連項目:

    • lower

      public E lower(E e)
      インタフェースからコピーされた説明: NavigableSet
      このセット内で、指定された要素よりも確実に小さい要素の中で最大のものを返します。そのような要素が存在しない場合はnullを返します。
      定義:
      lower、インタフェースNavigableSet<E>
      パラメータ:
      e - 照合する値
      戻り値:
      eよりも小さい要素の中で最大のもの。そのような要素が存在しない場合はnull
      スロー:
      ClassCastException - 指定された要素を、セット内に現在存在している要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • floor

      public E floor(E e)
      インタフェースからコピーされた説明: NavigableSet
      このセット内で、指定された要素と等しいかそれよりも小さい要素の中で最大のものを返します。そのような要素が存在しない場合はnullを返します。
      定義:
      floor、インタフェースNavigableSet<E>
      パラメータ:
      e - 照合する値
      戻り値:
      eと等しいか、それよりも小さい要素の中で最大のもの。そのような要素が存在しない場合はnull
      スロー:
      ClassCastException - 指定された要素を、セット内に現在存在している要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • ceiling

      public E ceiling(E e)
      インタフェースからコピーされた説明: NavigableSet
      このセット内で、指定された要素と等しいかそれよりも大きい要素の中で最小のものを返します。そのような要素が存在しない場合はnullを返します。
      定義:
      ceiling、インタフェースNavigableSet<E>
      パラメータ:
      e - 照合する値
      戻り値:
      eと等しいか、それよりも大きい要素の中で最小のもの。そのような要素が存在しない場合はnull
      スロー:
      ClassCastException - 指定された要素を、セット内に現在存在している要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • higher

      public E higher(E e)
      インタフェースからコピーされた説明: NavigableSet
      このセット内で、指定された要素よりも確実に大きい要素の中で最小のものを返します。そのような要素が存在しない場合はnullを返します。
      定義:
      higher、インタフェースNavigableSet<E>
      パラメータ:
      e - 照合する値
      戻り値:
      eよりも大きい要素の中で最小のもの。そのような要素が存在しない場合はnull
      スロー:
      ClassCastException - 指定された要素を、セット内に現在存在している要素と比較できない場合
      NullPointerException - 指定された要素がnullである場合

    • pollFirst

      public E pollFirst()
      インタフェースからコピーされた説明: NavigableSet
      最初の(最低)要素を取得して削除するか、このセットが空の(オプションの操作)の場合はnullを返します。
      定義:
      pollFirst、インタフェースNavigableSet<E>
      戻り値:
      最初の要素。このセットが空の場合はnull

    • pollLast

      public E pollLast()
      インタフェースからコピーされた説明: NavigableSet
      最後の(最高)要素を取得して削除するか、このセットが空の(オプションの操作)の場合はnullを返します。
      定義:
      pollLast、インタフェースNavigableSet<E>
      戻り値:
      最後の要素。このセットが空の場合はnull

    • comparator

      public Comparator<? super E> comparator()
      インタフェースからコピーされた説明: SortedSet
      このセットの要素の順序付けに使用されるコンパレータを返します。このセットが要素の「自然順序付け」を使用する場合はnullを返します。
      定義:
      comparator、インタフェースSortedSet<E>
      戻り値:
      このセットの要素の順序付けに使用されるコンパレータ。このセットで要素の自然順序付けを使用する場合はnull

    • first

      public E first()
      インタフェースからコピーされた説明: SortedSet
      セット内に現在ある最初(下端)の要素を返します。
      定義:
      first、インタフェースSortedSet<E>
      戻り値:
      セット内に現在ある最初(下端)の要素
      スロー:
      NoSuchElementException - このセットが空の場合

    • last

      public E last()
      インタフェースからコピーされた説明: SortedSet
      セット内に現在ある最後(上端)の要素を返します。
      定義:
      last、インタフェースSortedSet<E>
      戻り値:
      セット内に現在ある最後(上端)の要素
      スロー:
      NoSuchElementException - このセットが空の場合

    • addFirst

      public void addFirst(E e)
      UnsupportedOperationExceptionをスローします。 このセットの比較メソッドによって誘起される出現順序によって要素の位置が決定されるため、明示的な位置決めはサポートされていません。
      定義:
      インタフェースSequencedCollection<E>内のaddFirst
      定義:
      インタフェースSortedSet<E>内のaddFirst
      パラメータ:
      e - 追加する要素
      スロー:
      UnsupportedOperationException - 常時
      導入されたバージョン:
      21

    • addLast

      public void addLast(E e)
      UnsupportedOperationExceptionをスローします。 このセットの比較メソッドによって誘起される出現順序によって要素の位置が決定されるため、明示的な位置決めはサポートされていません。
      定義:
      インタフェースSequencedCollection<E>内のaddLast
      定義:
      インタフェースSortedSet<E>内のaddLast
      パラメータ:
      e - 追加する要素。
      スロー:
      UnsupportedOperationException - 常時
      導入されたバージョン:
      21

    • subSet

      public NavigableSet<E> subSet(E fromElement, boolean fromInclusive, E toElement, boolean toInclusive)
      インタフェースからコピーされた説明: NavigableSet
      このセットのfromElement - toElementの要素範囲を持つ部分のビューを返します。 fromElementとtoElementが等しい場合、返されるセットは、 fromInclusiveとtoInclusiveの両方がtrueでないかぎり、空になります。 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      定義:
      subSet、インタフェースNavigableSet<E>
      パラメータ:
      fromElement - 返されるセットの下端点
      fromInclusive - 返されるビューに下端点が含まれる場合はtrue
      toElement - 返されるセットの上端点
      toInclusive - 返されるビューに上端点が含まれる場合はtrue
      戻り値:
      このセットのfromElement (これを含む) - toElement (これを含まない)の要素範囲を持つ部分のビュー
      スロー:
      ClassCastException - このセットのコンパレータを使用して(このセットがコンパレータを持たない場合は自然順序付けを使用して)、fromElementとtoElementを相互に比較できない場合。 実装は、セット内に現在存在している要素とfromElementまたはtoElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromElementまたはtoElementがnullである場合
      IllegalArgumentException - fromElementがtoElementよりも大きい場合、またはこのセット自体が制限された範囲を持っており、fromElementまたはtoElementがその範囲から外れている場合

    • headSet

      public NavigableSet<E> headSet(E toElement, boolean inclusive)
      インタフェースからコピーされた説明: NavigableSet
      このセットのtoElementよりも小さい要素(inclusiveがtrueの場合はそれよりも小さいかそれと等しい要素)を含む部分のビューを返します。 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      定義:
      headSet、インタフェースNavigableSet<E>
      パラメータ:
      toElement - 返されるセットの上端点
      inclusive - 返されるビューに上端点が含まれる場合はtrue
      戻り値:
      このセットのtoElementよりも小さい要素(inclusiveがtrueの場合はそれよりも小さいかそれと等しい要素)を含む部分のビュー
      スロー:
      ClassCastException - toElementがこのセットのコンパレータと互換性がない場合(または、そのセットがコンパレータを持たない場合、toElementがComparableを実装していない場合)。 実装は、セット内に現在存在している要素とtoElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - toElementがnullである場合
      IllegalArgumentException - このセット自体が制限された範囲を持っており、toElementがその範囲から外れている場合

    • tailSet

      public NavigableSet<E> tailSet(E fromElement, boolean inclusive)
      インタフェースからコピーされた説明: NavigableSet
      このセットのfromElementよりも大きい要素(inclusiveがtrueの場合はそれよりも大きいかそれと等しい要素)を含む部分のビューを返します。 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      定義:
      tailSet、インタフェースNavigableSet<E>
      パラメータ:
      fromElement - 返されるセットの下端点
      inclusive - 返されるビューに下端点が含まれる場合はtrue
      戻り値:
      このセットのfromElementに等しいかそれよりも大きい要素を持つ部分のビュー
      スロー:
      ClassCastException - fromElementがこのセットのコンパレータと互換性がない場合(または、そのセットがコンパレータを持たない場合、fromElementがComparableを実装していない場合)。 実装は、セット内に現在存在している要素とfromElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromElementがnullである場合
      IllegalArgumentException - このセット自体が制限された範囲を持っており、fromElementがその範囲から外れている場合

    • subSet

      public NavigableSet<E> subSet(E fromElement, E toElement)
      インタフェースからコピーされた説明: NavigableSet
      このセットの要素の範囲がfromElement、包含的、排他的、toElementである部分のビューを返します。 (fromElementとtoElementが等しい場合、返されるセットは空です。) 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      subSet(fromElement, true, toElement, false)と同等です。

      定義:
      subSet、インタフェースNavigableSet<E>
      定義:
      subSet、インタフェースSortedSet<E>
      パラメータ:
      fromElement - 返されるセットの下端点(これを含む)
      toElement - 返されるセットの上端点(これを含まない)
      戻り値:
      このセットのfromElement (これを含む) - toElement (これを含まない)の要素範囲を持つ部分のビュー
      スロー:
      ClassCastException - このセットのコンパレータを使用して(このセットがコンパレータを持たない場合は自然順序付けを使用して)、fromElementとtoElementを相互に比較できない場合。 実装は、セット内に現在存在している要素とfromElementまたはtoElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromElementまたはtoElementがnullである場合
      IllegalArgumentException - fromElementがtoElementよりも大きい場合、またはこのセット自体が制限された範囲を持っており、fromElementまたはtoElementがその範囲から外れている場合

    • headSet

      public NavigableSet<E> headSet(E toElement)
      インタフェースからコピーされた説明: NavigableSet
      このセットの要素がtoElementより厳密に小さい部分のビューを返します。 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      headSet(toElement, false)と同等です。

      定義:
      headSet、インタフェースNavigableSet<E>
      定義:
      headSet、インタフェースSortedSet<E>
      パラメータ:
      toElement - 返されるセットの上端点(これを含まない)
      戻り値:
      このセットの要素が厳密にtoElementより小さい部分のビュー
      スロー:
      ClassCastException - toElementがこのセットのコンパレータと互換性がない場合(または、そのセットがコンパレータを持たない場合、toElementがComparableを実装していない場合)。 実装は、セット内に現在存在している要素とtoElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - toElementがnullである場合
      IllegalArgumentException - このセット自体が制限された範囲を持っており、toElementがその範囲から外れている場合

    • tailSet

      public NavigableSet<E> tailSet(E fromElement)
      インタフェースからコピーされた説明: NavigableSet
      要素がfromElement以上である、このセットの一部のビューを返します。 返されるセットはこのセットに連動しており、返されるセットでの変更はこのセットに反映され、その逆の場合も同様です。 返されるセットは、このセットがサポートする任意のセット・オペレーションをすべてサポートします。

      返されるセットは、その範囲外の要素が挿入されようとすると、IllegalArgumentExceptionをスローします。

      tailSet(fromElement, true)と同等です。

      定義:
      tailSet、インタフェースNavigableSet<E>
      定義:
      tailSet、インタフェースSortedSet<E>
      パラメータ:
      fromElement - 返されるセットの下端点(これを含む)
      戻り値:
      このセットのfromElementに等しいかそれよりも大きい要素を持つ部分のビュー
      スロー:
      ClassCastException - fromElementがこのセットのコンパレータと互換性がない場合(または、そのセットがコンパレータを持たない場合、fromElementがComparableを実装していない場合)。 実装は、セット内に現在存在している要素とfromElementとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromElementがnullである場合
      IllegalArgumentException - このセット自体が制限された範囲を持っており、fromElementがその範囲から外れている場合

    • descendingSet

      public NavigableSet<E> descendingSet()
      このセットに含まれる要素の逆順のビューを返します。 降順セットはこのセットに連動しており、このセットでの変更は降順セットに反映され、その逆の場合も同様です。

      返されるセットの順序付けは、Collections.reverseOrder(comparator())と同等になります。 式s.descendingSet().descendingSet()から返されるsのビューは基本的にsと同等になります。

      定義:
      descendingSet、インタフェースNavigableSet<E>
      戻り値:
      このセットの逆順のビュー

    • spliterator

      public Spliterator<E> spliterator()
      このセット内の要素に対するSpliteratorを返します。

      Spliteratorは、Spliterator.CONCURRENT、Spliterator.NONNULL、Spliterator.DISTINCT、Spliterator.SORTEDおよびSpliterator.ORDERED(昇順である検出順序で)を報告します。 オーバーライドする実装は、追加の特性値の報告をドキュメント化する必要があります。

      「コンパレータを設定」がnullの場合、「スプリッタのコンパレータ」はnullです。 それ以外の場合、スプリッテレータのコンパレータはセットのコンパレータと同じであるか、同じ全体順序付けを義務付けます。

      定義:
      spliterator、インタフェースCollection<E>
      定義:
      spliterator、インタフェースIterable<E>
      定義:
      spliterator、インタフェースSet<E>
      定義:
      spliterator、インタフェースSortedSet<E>
      戻り値:
      このセット内の要素に対するSpliterator
      導入されたバージョン:
      1.8