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) 시간 코스트를 제공합니다. 삽입, 삭제, 액세스의 각 오퍼레이션은, 복수의 thread에 의해 병행해, 안전하게 실행됩니다. 반복자는 「약일관성」을 가져, 어떤 시점 또는 반복자의 작성 이후세트 상태를 반영하는 요소를 돌려줍니다. 이것들은 ConcurrentModificationException 를 throw 하지 않고, 다른 오퍼레이션과의 동시성 처리가 가능합니다. 승순으로 늘어놓을 수 있었던 뷰와 그 반복자는, 내림차순의 경우보다 고속으로 됩니다.

대부분의 컬렉션과는 달라,size 메소드는 일정시간의 오퍼레이션은 아닌 것에 유의해 주세요. 이러한 세트에는 비동기라고 하는 특성이 있기 (위해)때문에, 현재의 요소수를 판정하려면 요소 전체를 횡단(traverse) 할 필요가 있습니다. 또,addAll,removeAll,retainAll, 및 containsAll 의 일괄 오퍼레이션은, 원자적인 실행은 보증되고 있지 않습니다. 예를 들어,addAll 오퍼레이션과 병행해 동작하는 반복자는, 추가된 요소의 일부 밖에 표시하지 않는 것이 있습니다.

이 클래스와 그 반복자는,Set 및 Iterator 인터페이스의 「옵션」메소드 모든 것을 구현합니다. 다른 대부분의 동시성 처리 컬렉션의 구현과 같이, 이 클래스는 null 요소의 사용을 허가하지 않습니다. 이것은,null 인수와 반환값은, 요소가 없는 경우와 확실히 구별할 수가 없기 때문입니다.

이 클래스는,Java Collections Framework 의 멤버입니다.

도입된 버젼:

1.6

관련 항목:

직렬화 된 형식

생성자 의 개요

ConcurrentSkipListSet ()
자연 순서부에 따라 요소를 순서 붙이고 하는, 새로운 빈 상태(empty)세트를 작성합니다.

ConcurrentSkipListSet (Collection <? extends E > c)
지정된 컬렉션내의 요소를 가져, 요소를 그자연 순서부에 따라 순서 붙이고 하는 새로운 세트를 작성합니다.

ConcurrentSkipListSet (Comparator <? super E > comparator)
지정된 Comparator에 따라 요소의 순서부를 실시하는, 새로운 빈 상태(empty)세트를 작성합니다.

ConcurrentSkipListSet (SortedSet <E > s)
지정된 소트 세트와 같은 요소를 가져, 같은 순서부를 사용하는, 새로운 세트를 작성합니다.

메소드의 개요

boolean	add (E e) 지정된 요소가 이 세트의 요소로서 존재하지 않는 경우에, 그 요소를 세트에 추가합니다.
E	ceiling (E e) 이 세트내에서, 지정된 요소와 동일한가 그것보다 큰 요소 속에서 최소의 것을 돌려줍니다.
void	clear () 모든 요소를 세트로부터 삭제합니다.
ConcurrentSkipListSet <E >	clone () ConcurrentSkipListSet 의 인스턴스의 shallow 복사를 돌려줍니다.
Comparator <? super E >	comparator () 이 세트내의 요소를 순서 붙이고 하는데 사용하는 Comparator를 돌려줍니다.
boolean	contains (Object o) 세트가, 지정된 요소를 보관 유지하고 있는 경우에 true 를 돌려줍니다.
Iterator <E >	descendingIterator () 이 세트의 요소의 반복자를 내림차순으로 돌려줍니다.
NavigableSet <E >	descendingSet () 세트내에 보관 유지되고 있는 요소의 뷰를 역순서로 돌려줍니다.
boolean	equals (Object o) 지정된 객체가 세트와 같은가 어떤가를 비교합니다.
E	first () 세트내에 현재 있는 최초 (하단)의 요소를 돌려줍니다.
E	floor (E e) 이 세트내에서, 지정된 요소와 동일한가 그것보다 작은 요소 속에서 최대의 것을 돌려줍니다.
NavigableSet <E >	headSet (E toElement) 세트의 toElement 보다 작은 요소를 가지는 부분의 뷰를 돌려줍니다.
NavigableSet <E >	headSet (E toElement, boolean inclusive) 이 세트의 toElement 보다 작은 요소 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 요소)를 포함한 부분의 뷰를 돌려줍니다.
E	higher (E e) 이 세트내에서, 지정된 요소보다 확실히 큰 요소 속에서 최소의 것을 돌려줍니다.
boolean	isEmpty () 세트가 요소를 1 개나 보관 유지하고 있지 않는 경우에 true 를 돌려줍니다.
Iterator <E >	iterator () 이 세트의 요소의 반복자를 승순으로 돌려줍니다.
E	last () 세트내에 현재 있는 최후 (상단)의 요소를 돌려줍니다.
E	lower (E e) 이 세트내에서, 지정된 요소보다 확실히 작은 요소 속에서 최대의 것을 돌려줍니다.
E	pollFirst () 최초 (하단)의 요소를 취득해 삭제합니다.
E	pollLast () 최후 (상단)의 요소를 취득해 삭제합니다.
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()

자연 순서부에 따라 요소를 순서 붙이고 하는, 새로운 빈 상태(empty)세트를 작성합니다.

ConcurrentSkipListSet

public ConcurrentSkipListSet(Comparator <?  super E > comparator)

지정된 Comparator에 따라 요소의 순서부를 실시하는, 새로운 빈 상태(empty)세트를 작성합니다.

파라미터:

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 의 인스턴스의 shallow 복사를 돌려줍니다. 그 요소는 복제되지 않습니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 세트의 shallow 복사

관련 항목:

Cloneable

size

public int size()

이 세트중의 요소의 수를 돌려줍니다. 이 세트에 Integer.MAX_VALUE 보다 많은 요소가 있는 경우는,Integer.MAX_VALUE 를 돌려줍니다.

대부분의 컬렉션과는 달라, 이 메소드는 일정시간의 오퍼레이션은 아닌 것에 유의해 주세요. 이러한 세트에는 비동기라고 하는 특성이 있기 (위해)때문에, 현재의 요소수를 판정하려면 요소 모든 것을 횡단(traverse) 해 카운트 할 필요가 있습니다. 또, 이 메소드의 실행중으로 사이즈가 변경될 가능성도 있어, 그 경우, 반환되는 값은 부정확하게 됩니다. 그 때문에, 이 메소드는, 일반적으로은 동시성 처리 어플리케이션에서는 별로 편리하지는 않습니다.

정의:

인터페이스 Collection <E > 내의 size

정의:

인터페이스 Set <E > 내의 size

정의:

클래스 AbstractCollection <E > 내의 size

반환값:

세트의 요소수

isEmpty

public boolean isEmpty()

세트가 요소를 1 개나 보관 유지하고 있지 않는 경우에 true 를 돌려줍니다.

정의:

인터페이스 Collection <E > 내의 isEmpty

정의:

인터페이스 Set <E > 내의 isEmpty

오버라이드(override):

클래스 AbstractCollection <E > 내의 isEmpty

반환값:

세트가 요소를 1 개나 보관 유지하고 있지 않는 경우는 true

contains

public boolean contains(Object  o)

세트가, 지정된 요소를 보관 유지하고 있는 경우에 true 를 돌려줍니다. 즉, 세트에,o.equals(e) 가 되는 요소 e 가 포함되어 있는 경우에만 true 를 돌려줍니다.

정의:

인터페이스 Collection <E > 내의 contains

정의:

인터페이스 Set <E > 내의 contains

오버라이드(override):

클래스 AbstractCollection <E > 내의 contains

파라미터:

o - 이 세트에 포함되어 있는지 어떤지를 조사하는 객체

반환값:

세트가, 지정된 요소를 보관 유지하고 있는 경우는 true

예외:

ClassCastException - 지정된 요소가 세트내에 현재 있는 요소와 비교 가능하지 않은 경우

NullPointerException - 지정된 요소가 null 인 경우

add

public boolean add(E  e)

지정된 요소가 이 세트의 요소로서 존재하지 않는 경우에, 그 요소를 세트에 추가합니다. 즉, 세트내에,e.equals(e2) 에 해당하는 요소 e2 가 없었던 경우는, 지정된 요소 e 를 세트에 추가합니다. 세트내에 벌써 요소가 있는 경우, 호출은 세트를 변경하지 않고 false 를 돌려줍니다.

정의:

인터페이스 Collection <E > 내의 add

정의:

인터페이스 Set <E > 내의 add

오버라이드(override):

클래스 AbstractCollection <E > 내의 add

파라미터:

e - 세트에 추가되는 요소

반환값:

세트가 지정된 요소를 보관 유지하고 있지 않았던 경우는 true

예외:

ClassCastException - e 가 세트내에 현재 있는 요소와 비교 가능하지 않은 경우

NullPointerException - 지정된 요소가 null 인 경우

remove

public boolean remove(Object  o)

지정된 요소가 이 세트에 존재하는 경우에, 요소를 세트로부터 삭제합니다. 즉, 세트내에,o.equals(e) 에 해당하는 요소 e 가 포함되어 있는 경우는, 그러한 요소를 삭제합니다. 요소가 세트내에 포함되어 있었을 경우 (세트가 호출의 결과로서 변경되었을 경우)는,true 를 돌려줍니다. 호출이 복귀한 뒤는, 세트는 그 요소를 가지지 않게 됩니다.

정의:

인터페이스 Collection <E > 내의 remove

정의:

인터페이스 Set <E > 내의 remove

오버라이드(override):

클래스 AbstractCollection <E > 내의 remove

파라미터:

o - 세트에 존재하면 삭제되는 객체

반환값:

세트가, 지정된 요소를 보관 유지하고 있는 경우는 true

예외:

ClassCastException - o 가 세트내에 현재 있는 요소와 비교 가능하지 않은 경우

NullPointerException - 지정된 요소가 null 인 경우

clear

public void clear()

모든 요소를 세트로부터 삭제합니다.

정의:

인터페이스 Collection <E > 내의 clear

정의:

인터페이스 Set <E > 내의 clear

오버라이드(override):

클래스 AbstractCollection <E > 내의 clear

iterator

public Iterator <E > iterator()

이 세트의 요소의 반복자를 승순으로 돌려줍니다.

정의:

인터페이스 Iterable <E > 내의 iterator

정의:

인터페이스 Collection <E > 내의 iterator

정의:

인터페이스 NavigableSet <E > 내의 iterator

정의:

인터페이스 Set <E > 내의 iterator

정의:

클래스 AbstractCollection <E > 내의 iterator

반환값:

승순의, 이 세트의 요소의 반복자

descendingIterator

public Iterator <E > descendingIterator()

이 세트의 요소의 반복자를 내림차순으로 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 descendingIterator

반환값:

내림차순의, 이 세트의 요소의 반복자

equals

public boolean equals(Object  o)

지정된 객체가 세트와 같은가 어떤가를 비교합니다. 지정된 객체도 세트로, 2 개세트가 같은 사이즈를 가져, 지정된 세트의 모든 멤버가 이 세트에 포함되는 경우, 또는, 이 세트의 모든 멤버가 지정된 세트에 포함되는 경우는,true 를 돌려줍니다. 이 정의에 의해, equals 메소드가 세트 인터페이스의 다양한 구현으로 적절히 동작하는 것이 보증됩니다.

정의:

인터페이스 Collection <E > 내의 equals

정의:

인터페이스 Set <E > 내의 equals

오버라이드(override):

클래스 AbstractSet <E > 내의 equals

파라미터:

o - 이 세트와 동일한지 어떤지를 비교하는 객체

반환값:

지정된 객체가 이 세트와 같은 경우는 true

관련 항목:

Object.hashCode() , Hashtable

removeAll

public boolean removeAll(Collection <? > c)

세트로부터, 지정된 컬렉션내에 보관 유지 떠날 수 있어 모든 요소를 삭제합니다. 지정된 컬렉션도 세트인 경우, 이 오퍼레이션은, 값이 2 개세트의 「비대칭 집합 차분」이 되도록(듯이) 세트를 효율적으로 변경합니다.

정의:

인터페이스 Collection <E > 내의 removeAll

정의:

인터페이스 Set <E > 내의 removeAll

오버라이드(override):

클래스 AbstractSet <E > 내의 removeAll

파라미터:

c - 이 세트로부터 삭제되는 요소를 포함한 컬렉션

반환값:

이 호출의 결과, 이 세트가 변경되었을 경우는 true

예외:

ClassCastException - 이 컬렉션의 1 개 또는 복수의 요소의 형태가, 지정된 세트와 호환이 아닌 경우

NullPointerException - 지정된 컬렉션 또는, 그 요소중 한쪽이 null 의 경우

관련 항목:

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

lower

public E  lower(E  e)

인터페이스 NavigableSet 의 기술:

이 세트내에서, 지정된 요소보다 확실히 작은 요소 속에서 최대의 것을 돌려줍니다. 그러한 요소가 존재하지 않는 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 lower

파라미터:

e - 조합하는 값

반환값:

e 보다 작은 요소 속에서 최대의 것. 그러한 요소가 존재하지 않는 경우는 null

예외:

ClassCastException - 지정된 요소를, 세트내에 현재 존재하고 있는 요소와 비교할 수 없는 경우

NullPointerException - 지정된 요소가 null 인 경우

floor

public E  floor(E  e)

인터페이스 NavigableSet 의 기술:

이 세트내에서, 지정된 요소와 동일한가 그것보다 작은 요소 속에서 최대의 것을 돌려줍니다. 그러한 요소가 존재하지 않는 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 floor

파라미터:

e - 조합하는 값

반환값:

e 와 동일한가 그것보다 작은 요소 속에서 최대의 것. 그러한 요소가 존재하지 않는 경우는 null

예외:

ClassCastException - 지정된 요소를, 세트내에 현재 존재하고 있는 요소와 비교할 수 없는 경우

NullPointerException - 지정된 요소가 null 인 경우

ceiling

public E  ceiling(E  e)

인터페이스 NavigableSet 의 기술:

이 세트내에서, 지정된 요소와 동일한가 그것보다 큰 요소 속에서 최소의 것을 돌려줍니다. 그러한 요소가 존재하지 않는 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 ceiling

파라미터:

e - 조합하는 값

반환값:

e 와 동일한가 그것보다 큰 요소 속에서 최소의 것. 그러한 요소가 존재하지 않는 경우는 null

예외:

ClassCastException - 지정된 요소를, 세트내에 현재 존재하고 있는 요소와 비교할 수 없는 경우

NullPointerException - 지정된 요소가 null 인 경우

higher

public E  higher(E  e)

인터페이스 NavigableSet 의 기술:

이 세트내에서, 지정된 요소보다 확실히 큰 요소 속에서 최소의 것을 돌려줍니다. 그러한 요소가 존재하지 않는 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 higher

파라미터:

e - 조합하는 값

반환값:

e 보다 큰 요소 속에서 최소의 것. 그러한 요소가 존재하지 않는 경우는 null

예외:

ClassCastException - 지정된 요소를, 세트내에 현재 존재하고 있는 요소와 비교할 수 없는 경우

NullPointerException - 지정된 요소가 null 인 경우

pollFirst

public E  pollFirst()

인터페이스 NavigableSet 의 기술:

최초 (하단)의 요소를 취득해 삭제합니다. 이 세트가 빈 상태(empty)의 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 pollFirst

반환값:

최초의 요소. 이 세트가 빈 상태(empty)의 경우는 null

pollLast

public E  pollLast()

인터페이스 NavigableSet 의 기술:

최후 (상단)의 요소를 취득해 삭제합니다. 이 세트가 빈 상태(empty)의 경우는 null 를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 pollLast

반환값:

마지막 요소. 이 세트가 빈 상태(empty)의 경우는 null

comparator

public Comparator <?  super E > comparator()

인터페이스 SortedSet 의 기술:

이 세트내의 요소를 순서 붙이고 하는데 사용하는 Comparator를 돌려줍니다. 다만, 이 세트가 그 요소 자연 순서부 를 사용하는 경우는 null 를 돌려줍니다.

정의:

인터페이스 SortedSet <E > 내의 comparator

반환값:

이 세트내의 요소를 순서 붙이고 하는데 사용하는 Comparator. 다만, 이 세트가 그 요소의 자연 순서부를 사용하는 경우는 null

first

public E  first()

인터페이스 SortedSet 의 기술:

세트내에 현재 있는 최초 (하단)의 요소를 돌려줍니다.

정의:

인터페이스 SortedSet <E > 내의 first

반환값:

세트내에 현재 있는 최초 (하단)의 요소

예외:

NoSuchElementException - 세트가 빈 상태(empty)의 경우

last

public E  last()

인터페이스 SortedSet 의 기술:

세트내에 현재 있는 최후 (상단)의 요소를 돌려줍니다.

정의:

인터페이스 SortedSet <E > 내의 last

반환값:

세트내에 현재 있는 최후 (상단)의 요소

예외:

NoSuchElementException - 세트가 빈 상태(empty)의 경우

subSet

public NavigableSet <E > subSet(E  fromElement,
                              boolean fromInclusive,
                              E  toElement,
                              boolean toInclusive)

인터페이스 NavigableSet 의 기술:

세트의 fromElement ~ toElement 의 요소 범위를 가지는 부분의 뷰를 돌려줍니다. fromElement 와 toElement 가 동일한 경우, 반환되는 세트는 비웁니다. 다만,fromExclusive 와 toExclusive 가 어느쪽이나 true 의 경우는 제외합니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

정의:

인터페이스 NavigableSet <E > 내의 subSet

파라미터:

fromElement - 반환되는 세트의 하단점

fromInclusive - 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true

toElement - 반환되는 세트의 상단점

toInclusive - 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true

반환값:

세트의 fromElement (포함한다) ~ toElement (포함하지 않는다)의 요소 범위를 가지는 부분의 뷰

예외:

ClassCastException - 이 세트의 Comparator를 사용해 (이 세트가 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromElement 와 toElement 와의 상호 비교를 실시할 수 없는 경우. 구현은, 세트내에 현재 존재하고 있는 요소와 fromElement 또는 toElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromElement 또는 toElement 가 null 의 경우

IllegalArgumentException - fromElement 가 toElement 보다 큰 경우, 또는 이 세트 자체가 제한된 범위를 가지고 있어fromElement 또는 toElement 가 그 범위의 경계의 외측에 있는 경우

headSet

public NavigableSet <E > headSet(E  toElement,
                               boolean inclusive)

인터페이스 NavigableSet 의 기술:

이 세트의 toElement 보다 작은 요소 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 요소)를 포함한 부분의 뷰를 돌려줍니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

정의:

인터페이스 NavigableSet <E > 내의 headSet

파라미터:

toElement - 반환되는 세트의 상단점

inclusive - 반환되는 뷰에 상단점이 포함되도록(듯이) 하는 경우는 true

반환값:

이 세트의 toElement 보다 작은 요소 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 요소)를 포함한 부분의 뷰

예외:

ClassCastException - toElement 가 이 세트의 Comparator와 호환성이 없는 경우 (또는, 이 세트가 Comparator를 가지지 않는 경우,toElement 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 세트내에 현재 존재하고 있는 요소와 toElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - toElement 가 null 의 경우

IllegalArgumentException - 이 세트 자체가 제한된 범위를 가지고 있어toElement 가 그 범위의 경계의 외측에 있는 경우

tailSet

public NavigableSet <E > tailSet(E  fromElement,
                               boolean inclusive)

인터페이스 NavigableSet 의 기술:

이 세트의 fromElement 보다 큰 요소 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 요소)를 포함한 부분의 뷰를 돌려줍니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

정의:

인터페이스 NavigableSet <E > 내의 tailSet

파라미터:

fromElement - 반환되는 세트의 하단점

inclusive - 반환되는 뷰에 하단점이 포함되도록(듯이) 하는 경우는 true

반환값:

세트의 fromElement 에 동일한가 이것보다 큰 요소를 가지는 부분의 뷰

예외:

ClassCastException - fromElement 가 이 세트의 Comparator와 호환성이 없는 경우 (또는, 이 세트가 Comparator를 가지지 않는 경우,fromElement 가 Comparable 를 구현하고 있지 않는 경우). 구현은, 세트내에 현재 존재하고 있는 요소와 fromElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromElement 가 null 의 경우

IllegalArgumentException - 이 세트 자체가 제한된 범위를 가지고 있어fromElement 가 그 범위의 경계의 외측에 있는 경우

subSet

public NavigableSet <E > subSet(E  fromElement,
                              E  toElement)

인터페이스 NavigableSet 의 기술:

세트의 fromElement (이것을 포함한다) ~ toElement (이것을 포함하지 않는다)의 요소 범위를 가지는 부분의 뷰를 돌려줍니다. fromElement 와 toElement 가 동일한 경우는, 빈 상태(empty)세트가 돌려주어집니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

subSet(fromElement, true, toElement, false) 와 등가입니다.

정의:

인터페이스 NavigableSet <E > 내의 subSet

정의:

인터페이스 SortedSet <E > 내의 subSet

파라미터:

fromElement - 반환되는 세트의 하단점 (이것을 포함한다)

toElement - 반환되는 세트의 상단점 (이것을 포함하지 않는다)

반환값:

세트의 fromElement (이것을 포함한다) ~ toElement (이것을 포함하지 않는다)의 요소 범위를 가지는 부분의 뷰

예외:

ClassCastException - 이 세트의 Comparator를 사용해 (이 세트가 Comparator를 가지지 않는 경우는 자연 순서부를 사용해) fromElement 와 toElement 와의 상호 비교를 실시할 수 없는 경우. 구현은, 세트내에 현재 존재하고 있는 요소와 fromElement 또는 toElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromElement 또는 toElement 가 null 의 경우

IllegalArgumentException - fromElement 가 toElement 보다 큰 경우, 또는 이 세트 자체가 제한된 범위를 가지고 있어fromElement 또는 toElement 가 그 범위의 경계의 외측에 있는 경우

headSet

public NavigableSet <E > headSet(E  toElement)

인터페이스 NavigableSet 의 기술:

세트의 toElement 보다 작은 요소를 가지는 부분의 뷰를 돌려줍니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

headSet(toElement, false) 와 등가입니다.

정의:

인터페이스 NavigableSet <E > 내의 headSet

정의:

인터페이스 SortedSet <E > 내의 headSet

파라미터:

toElement - 반환되는 세트의 상단점 (이것을 포함하지 않는다)

반환값:

세트의 toElement 보다 작은 요소를 가지는 부분의 뷰

예외:

ClassCastException - toElement 가 세트의 Comparator와 호환성이 없는 경우 (또는, 세트에 Comparator가 없는 경우,toElement 에 Comparable 가 구현되어 있지 않은 경우). 구현은, 세트내에 현재 존재하고 있는 요소와 toElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - toElement 가 null 의 경우

IllegalArgumentException - 이 세트 자체가 제한된 범위를 가지고 있어toElement 가 그 범위의 경계의 외측에 있는 경우

tailSet

public NavigableSet <E > tailSet(E  fromElement)

인터페이스 NavigableSet 의 기술:

세트의 fromElement 에 동일한가 이것보다 큰 요소를 가지는 부분의 뷰를 돌려줍니다. 반환되는 세트는 이 세트에 연동하고 있어, 반환되는 세트에서의 변경은 이 세트에 반영되어 그 역의 경우도 같습니다. 반환되는 세트는, 이 세트가 지원하는 옵션세트 오퍼레이션을 모두 지원합니다.

반환된 세트는, 그 범위외의 요소가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

tailSet(fromElement, true) 와 등가입니다.

정의:

인터페이스 NavigableSet <E > 내의 tailSet

정의:

인터페이스 SortedSet <E > 내의 tailSet

파라미터:

fromElement - 반환되는 세트의 하단점 (이것을 포함한다)

반환값:

세트의 fromElement 에 동일한가 이것보다 큰 요소를 가지는 부분의 뷰

예외:

ClassCastException - fromElement 가 이 세트의 Comparator와 호환성이 없는 경우 (또는, 세트에 Comparator가 없는 경우, fromElement 에 Comparable 가 구현되어 있지 않은 경우). 구현은, 세트내에 현재 존재하고 있는 요소와 fromElement 를 비교할 수 없는 경우에 이 예외를 throw 할 수가 있다. 다만, 필수는 아니다

NullPointerException - fromElement 가 null 의 경우

IllegalArgumentException - 이 세트 자체가 제한된 범위를 가지고 있어fromElement 가 그 범위의 경계의 외측에 있는 경우

descendingSet

public NavigableSet <E > descendingSet()

세트내에 보관 유지되고 있는 요소의 뷰를 역순서로 돌려줍니다. 내림차순세트는 이 세트에 연동하고 있어, 세트에의 변경은 내림차순세트에 반영되어 그 역도 같습니다.

반환되는 세트의 순서는,Collections.reverseOrder (comparator()) 와 같습니다. 식 s.descendingSet(). descendingSet() 는, 본질적으로는 s 와 같은 s 의 뷰를 돌려줍니다.

정의:

인터페이스 NavigableSet <E > 내의 descendingSet

반환값:

이 세트의 역의순서의 뷰