java.util.concurrent

クラス 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>, Set<E>, SortedSet<E>

public class ConcurrentSkipListSet<E>
extends AbstractSet<E>
implements NavigableSet<E>, Cloneable, Serializable

ConcurrentSkipListMap に基づくスケーラブルな並行 NavigableSet 実装です。セットの要素は、どのコンストラクタが使用されているかに応じて、その自然順序付けに従って、またはセット作成時に提供される Comparator によってソートされます。

この実装は、contains、add、および remove オペレーションとそれらのバリアントに予想される平均 log(n) 時間コストを提供します。挿入、削除、アクセスの各オペレーションは、複数のスレッドによって並行して、安全に実行されます。イテレータは弱一貫性を持ち、ある時点での、またはイテレータの作成以降のセットの状態を反映する要素を返します。これらは ConcurrentModificationException をスローせず、ほかのオペレーションとの並行処理が可能です。昇順で並べられたビューとそのイテレータは、降順の場合よりも高速になります。

大半のコレクションとは異なり、size メソッドは一定時間のオペレーションではないことに留意してください。これらのセットには非同期という特性があるため、現在の要素数を判定するには要素のトラバーサルが必要になります。そのため、このコレクションがトラバーサル中に変更された場合は、不正確な結果が報告される可能性があります。さらに、addAll、removeAll、retainAll、containsAll、equals、および toArray の一括オペレーションは、原子的な実行は保証されていません。たとえば、addAll オペレーションと並行して動作するイテレータは、追加された要素の一部しか表示しないことがあります。

このクラスとそのイテレータは、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) 指定された要素がセットの要素として存在しない場合に、その要素をセットに追加します。
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() このセット中の要素の数を返します。
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 の場合はそれよりも大きいかそれと等しい要素) を含む部分のビューを返します。

クラス java.util.AbstractSet から継承されたメソッド

hashCode

クラス java.util.AbstractCollection から継承されたメソッド

addAll, containsAll, retainAll, toArray, toArray, toString

クラス java.lang.Object から継承されたメソッド

finalize, getClass, notify, notifyAll, wait, wait, wait

インタフェース java.util.Set から継承されたメソッド

addAll, containsAll, hashCode, retainAll, toArray, toArray

コンストラクタの詳細

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

戻り値:

このセットのシャローコピー

関連項目:

Cloneable

size

public int size()

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

大半のコレクションとは異なり、このメソッドは一定時間のオペレーションではないことに留意してください。これらのセットには非同期という特性があるため、現在の要素数を判定するには要素すべてをトラバースしてカウントする必要があります。また、このメソッドの実行中にサイズが変更される可能性もあり、その場合、返される値は不正確になります。そのため、このメソッドは、通常は並行処理アプリケーションではあまり便利ではありません。

定義:

size、インタフェース: Collection<E>

定義:

size、インタフェース: Set<E>

定義:

size、クラス: AbstractCollection<E>

戻り値:

セットの要素数

isEmpty

public boolean isEmpty()

このセットに要素が 1 つも含まれていない場合に true を返します。

定義:

isEmpty、インタフェース: Collection<E>

定義:

isEmpty、インタフェース: Set<E>

オーバーライド:

isEmpty、クラス: AbstractCollection<E>

戻り値:

このセットに要素が 1 つも含まれていない場合は 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、インタフェース: Iterable<E>

定義:

iterator、インタフェース: Collection<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

関連項目:

Object.hashCode()、HashMap

removeAll

public boolean removeAll(Collection<?> c)

セットから、指定されたコレクション内に保持されているすべての要素を削除します。指定されたコレクションもセットである場合、このオペレーションは、その値が 2 つのセットの非対称集合差分になるようにこのセットを効率的に変更します。

定義:

removeAll、インタフェース: Collection<E>

定義:

removeAll、インタフェース: Set<E>

オーバーライド:

removeAll、クラス: AbstractSet<E>

パラメータ:

c - このセットから削除される要素を含むコレクション

戻り値:

呼び出しの結果としてこのセットが変更された場合は true

例外:

ClassCastException - このセット内の 1 つまたは複数の要素の型が、指定されたコレクションと互換性がない場合

NullPointerException - 指定されたコレクションまたはそのいずれかの要素が null である場合

関連項目:

AbstractCollection.remove(Object), AbstractCollection.contains(Object)

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 - このセットが空の場合

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>

戻り値:

このセットの逆順のビュー