java.util
클래스 TreeMap<K, V>

java.lang.Object 
  java.util.AbstractMap <K, V>
      java.util.TreeMap<K, V>

모든 구현된 인터페이스:

Serializable, Cloneable, Map <K, V>, SortedMap <K, V>

public class TreeMap<K, V>
extends AbstractMap <K, V>
implements SortedMap <K, V>, Cloneable,
 Serializable 

SortedMap 인터페이스의 구현에 근거하는 Red-Black 트리입니다. 이 클래스에서는 맵이 확실히 키의 승순으로 소트 됩니다. 다만, 소트 방법은 생성자에 의해 달라, 키의 클래스의 「자연 정렬」(Comparable를 참조)에 의해 소트 되는 경우와 작성시에 제공되는 컴퍼레이터에 의해 소트 되는 경우가 있습니다.

이 구현은, containsKey, get, put, remove 각 오퍼레이션에 보증 끝난 log(n) 시간 코스트를 제공합니다. 알고리즘은 Cormen, Leiserson, Rivest 「Introduction to Algorithms」의 것에 손보고 있습니다.

소트 맵에 의해 Map 인터페이스를 올바르게 구현하는 경우는 명시적인 컴퍼레이터 의 제공의 유무에 관계없이, 소트 맵으로 관리되는 순서부는 「equals와 일관성」이 필요합니다 ( 「equals와 의 일관성」의 정확한 정의에 대해서는 Comparable 또는 Comparator를 참조). 이것은 Map 인터페이스가 equals 오퍼레이션에 근거해 정의되기 때문에입니다만, 맵은 그 compareTo 메서드 또는 compare 메서드를 사용해 모든 키를 비교하므로 이 메서드에 의해 동일하다고 보여지는 2개의 키는 소트 맵으로부터 봐도 같습니다. 소트 맵의 동작은 그 순서부가 equals와 일관성이 없는 경우에서도 명확하게 정의되고 있습니다만, Map 인터페이스의 일반 규약에는 준거하고 있습니다.

이 구현은 동기화 되지 않습니다. 복수의 thread가 동시에 맵에 접속해, 그러한 thread의 적어도 1개이 구조적으로 맵을 변경하는 경우에는 외부에서 동기를 잡을 필요가 있습니다. 구조적인 변경이란 1개 이상의 매핑을 추가 또는 삭제하는 것 같은 오퍼레이션입니다. 기존의 키에 관련된 값을 변경하는 처리는 구조적인 변경이 아닙니다. 보통, 구조적인 변경은 맵을 자연스럽게 캡슐화하는 특정의 객체로 동기를 잡는 것에 의해 달성됩니다. 그러한 객체가 없는 경우에는 Collections.synchronizedMap 메서드를 사용해 맵을 「랩」합니다. 맵에의 우발적인 비동기 액세스를 막기 위해서 작성시에 실시하는 것이 최적입니다.

     Map m = Collections.synchronizedMap(new TreeMap(...));
 

이 클래스의 「코레크션뷰메서드」에 의해 리턴된 반복자는 「페이르파스트」입니다. 즉, 반복자의 작성 후에 반복자 자체의 remove 메서드 또는 add 메서드 이외 방법으로 맵이 구조적으로 변경되면, 반복자는 ConcurrentModificationException을 Throw 합니다. 따라서, 동시에 변경을 하면, 반복자는 장래의 예측할 수 없는 시점에 있어 예측할 수 없는 동작이 발생하는 위험을 회피하기 위해서 즉시 한편 솜씨 자주 예외를 Throw 합니다.

보통, 비동기의 동시 변경이 있는 경우, 확실한 보증을 실시하는 것은 불가능해서, 반복자의 페이르파스트의 동작을 보증할 수 없습니다. 페이르파스트 반복자는 최선 노력 원칙에 기반해 ConcurrentModificationException을 Throw 합니다. 따라서, 정확을 기하기 위해서 이 예외에 의존된 프로그램을 쓰는 것은 잘못입니다. 「반복자의 페이르파스트의 동작은 버그를 검출하기 위해서 마셔 사용해야 합니다」

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

도입된 버전 :

1.2

관련 항목:

Map, HashMap, Hashtable, Comparable, Comparator, Collection, Collections.synchronizedMap(Map), 직렬화 된 형식

생성자 개요

TreeMap ()
키의 자연 순서부에 따라 소트된, 새로운 비어있는 맵을 작성합니다.

TreeMap (Comparator <? super K > c)
지정된 컴퍼레이터에 따라 소트된, 새로운 비어있는 맵을 작성합니다.

TreeMap (Map <? extends K, ? extends V > m)
지정된 맵과 같은 매핑을 가져, 키의 「자연 정렬」에 따라 소트된 새로운 맵을 작성합니다.

TreeMap (SortedMap <K, ? extends V > m)
지정된 SortedMap와 같은 매핑을 가져, 같은 순서부에 따라 소트된, 새로운 맵을 작성합니다.

메서드 개요

void	clear () TreeMap 로부터 모든 매핑을 삭제합니다.
Object	clone () TreeMap 인스턴스의 샤로코피를 리턴합니다.
Comparator <? super K >	comparator () 맵을 정렬 하는데 사용하는 컴퍼레이터를 리턴합니다.
boolean	containsKey (Object key) 맵이 지정된 키의 매핑을 보관 유지하는 경우에 true를 리턴합니다.
boolean	containsValue (Object value) 맵이 1개 이상의 키가 지정된 값에 맵 하는 경우에 true를 리턴합니다.
Set <Map.Entry <K, V >>	entrySet () 맵내에 보관 유지되고 있는 매핑의 셋트뷰를 리턴합니다.
K	firstKey () 소트 맵내에 현재 있는 최초 (하단)의 키를 리턴합니다.
V	get (Object key) 맵이 지정된 키를 맵 하는 값을 리턴합니다.
SortedMap <K, V >	headMap (K toKey) 맵의 toKey 보다 작은 키를 가지는 부분의 뷰를 리턴합니다.
Set <K >	keySet () 맵내에 보관 유지되고 있는 키의 Set 뷰를 리턴합니다.
K	lastKey () 소트 맵내에 현재 있는 최후 (상단)의 키를 리턴합니다.
V	put (K key, V value) 지정된 값과 지정된 키를 이 맵에 관련짓습니다.
void	putAll (Map <? extends K, ? extends V > map) 지정된 맵으로부터 모든 매핑을 맵에 카피합니다.
V	remove (Object key) 키의 매핑이 있으면 TreeMap 로부터 삭제합니다.
int	size () 맵내의 키치 매핑의 수를 리턴합니다.
SortedMap <K, V >	subMap (K fromKey, K toKey) 맵의 fromKey (이것을 포함한다) ~ toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰를 리턴합니다.
SortedMap <K, V >	tailMap (K fromKey) 맵의 fromKey 이상의 키를 가지는 부분의 뷰를 리턴합니다.
Collection <V >	values () 맵내에 보관 유지되고 있는 값의 코레크션뷰를 리턴합니다.

클래스 java.util. AbstractMap 로부터 상속된 메서드

equals, hashCode, isEmpty, toString

클래스 java.lang. Object 로부터 상속된 메서드

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

인터페이스 java.util. Map 로부터 상속된 메서드

equals, hashCode, isEmpty

생성자 상세

TreeMap

public TreeMap()

키의 자연 순서부에 따라 소트된, 새로운 비어있는 맵을 작성합니다. 맵에 삽입된 모든 키는 Comparable 인터페이스를 구현할 필요가 있습니다. 게다가 각 키는 「서로 비교 가능」일 필요가 있습니다. 즉, k1.compareTo(k2)는 맵내의 임의의 요소 k1와 k2 어느 쪽에 대해서도 ClassCastException을 Throw 해야 하지는 않습니다. 예를 들어 키가 정수의 맵에 캐릭터 라인 키를 넣으려고 하는 등, 사용자가 이 제약에 위반하는 키를 맵에 넣으려고 하면, put(Object key, Object value) 호출이 ClassCastException을 Throw 합니다.

관련 항목:

Comparable

TreeMap

public TreeMap(Comparator <?  super K > c)

지정된 컴퍼레이터에 따라 소트된, 새로운 비어있는 맵을 작성합니다. 맵에 삽입된 모든 키는 지정된 컴퍼레이터에 의해 「서로 비교 가능」일 필요가 있습니다. 즉, comparator.compare(k1, k2)는 맵내의 임의의 키 k1와 k2 어느 쪽에 대해서도 ClassCastException을 Throw 해야 하지는 않습니다. 사용자가 이 제약에 위반하는 키를 맵에 넣으려고 하면, put(Object key, Object value) 호출이 ClassCastException을 Throw 합니다.

파라미터:

c - 이 맵을 소트 하기 위해서 사용되는 컴퍼레이터. null 치는 키의 「자연 정렬」를 사용하는 것을 나타낸다

TreeMap

public TreeMap(Map <?  extends K,
?  extends V > m)

지정된 맵과 같은 매핑을 가져, 키의 「자연 정렬」에 따라 소트된 새로운 맵을 작성합니다. 새로운 맵에 삽입된 모든 키는 Comparable 인터페이스를 구현할 필요가 있습니다. 게다가 각 키는 「서로 비교 가능」일 필요가 있습니다. 즉, k1.compareTo(k2)는 맵내의 임의의 요소 k1와 k2 어느 쪽에 대해서도 ClassCastException을 Throw 해야 하지는 않습니다. 이 메서드는 n*log(n) 시간에 실행됩니다.

파라미터:

m - 매핑이 이 맵에 배치되는 맵

예외:

ClassCastException - t 내의 키가 Comparable가 아닌지, 서로 비교 가능하지 않은 경우

NullPointerException - 지정된 맵이 null인 경우

TreeMap

public TreeMap(SortedMap <K,
?  extends V > m)

지정된 SortedMap와 같은 매핑을 가져, 같은 순서부에 따라 소트된, 새로운 맵을 작성합니다. 이 메서드는 선형 시간에 실행됩니다.

파라미터:

m - 매핑이 이 맵에 배치되어 컴퍼레이터가 이 맵의 소트에 사용되는 소트된 맵

예외:

NullPointerException - 지정된 소트 맵이 null인 경우

메서드의 상세

size

public int size()

맵내의 키치 매핑의 수를 리턴합니다.

정의:

인터페이스 Map <K, V > 내의 size

오버라이드(override):

클래스 AbstractMap <K, V > 내의 size

반환값:

맵내의 키와 값의 매핑의 수

containsKey

public boolean containsKey(Object  key)

맵이 지정된 키의 매핑을 보관 유지하는 경우에 true를 리턴합니다.

정의:

인터페이스 Map <K, V > 내의 containsKey

오버라이드(override):

클래스 AbstractMap <K, V > 내의 containsKey

파라미터:

key - 맵에 있을지 어떨지가 판정되는 키

반환값:

맵이 지정된 키의 매핑을 보관 유지하는 경우는 true

예외:

ClassCastException - 키가 맵내에 현재 있는 키와 비교할 수 없는 경우

NullPointerException - 키가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

containsValue

public boolean containsValue(Object  value)

맵이 1개 이상의 키가 지정된 값에 맵 하는 경우에 true를 리턴합니다. 즉, 맵이 (value==null ? v==null : value.equals(v))와 같은 값 v에 의 매핑을 1개 이상 보관 유지하고 있는 경우에만 true를 리턴합니다. 이 오퍼레이션에 걸리는 시간은 아마, Map 대부분의 구현의 Map 사이즈에 비례합니다.

정의:

인터페이스 Map <K, V > 내의 containsValue

오버라이드(override):

클래스 AbstractMap <K, V > 내의 containsValue

파라미터:

value - Map에 있을지 어떨지를 판정되는 값

반환값:

value에 의 매핑이 있는 경우는 true, 매핑이 없는 경우는 false

도입된 버전 :

1.2

get

public V  get(Object  key)

맵이 지정된 키를 맵 하는 값을 리턴합니다. 맵이 이 키의 매핑을 보관 유지하고 있지 않는 경우는 null을 리턴합니다. 반환값의 null는 맵이 키의 매핑을 보관 유지하고 있지 않는 것을 나타낸다고는인가 선. 즉, 맵이 명시적으로 키를 null에 맵 하는 일도 있습니다. containsKey 오퍼레이션을 사용하면, 이러한 2개의 경우를 분별할 수 있습니다 .

정의:

인터페이스 Map <K, V > 내의 get

오버라이드(override):

클래스 AbstractMap <K, V > 내의 get

파라미터:

key - 관련된 값이 리턴된 키

반환값:

맵이, 지정된 키에 매핑 하고 있는 값. 키에 대한 매핑이 맵에 없는 경우는 null

예외:

ClassCastException - 키가 맵내에 현재 있는 키와 비교할 수 없는 경우

NullPointerException - 키가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

관련 항목:

containsKey(Object)

comparator

public Comparator <?  super K > comparator()

맵을 정렬 하는데 사용하는 컴퍼레이터를 리턴합니다. 다만, 맵이 그 키의 자연 순서부를 사용하는 경우는 null을 리턴합니다.

정의:

인터페이스 SortedMap <K, V > 내의 comparator

반환값:

소트 맵에 관련한 컴퍼레이터. 소트 맵이 그 키의 자연 소트 메서드를 사용하는 경우는 null

firstKey

public K  firstKey()

소트 맵내에 현재 있는 최초 (하단)의 키를 리턴합니다.

정의:

인터페이스 SortedMap <K, V > 내의 firstKey

반환값:

소트 맵내에 현재 있는 최초 (하단)의 키

예외:

NoSuchElementException - Map이 비어있는 경우

lastKey

public K  lastKey()

소트 맵내에 현재 있는 최후 (상단)의 키를 리턴합니다.

정의:

인터페이스 SortedMap <K, V > 내의 lastKey

반환값:

소트 맵내에 현재 있는 최후 (상단)의 키

예외:

NoSuchElementException - Map이 비어있는 경우

putAll

public void putAll(Map <?  extends K,
?  extends V > map)

지정된 맵으로부터 모든 매핑을 맵에 카피합니다. 이것에 의해 맵이 지정된 맵내에 현재 있는 키의 모두에 대해서 가지고 있던 매핑을 옮겨놓을 수 있습니다.

정의:

인터페이스 Map <K, V > 내의 putAll

오버라이드(override):

클래스 AbstractMap <K, V > 내의 putAll

파라미터:

map - 맵에 포함되는 매핑

예외:

ClassCastException - 지정된 맵내의 키 또는 값의 클래스가 키 또는 값을 맵내에 포함시키지 않게 하는 경우

NullPointerException - 지정된 맵이 null인 경우, 혹은 이 맵이 null 키를 허용 하지 않고, 지정된 맵내의 키가 null인 경우

put

public V  put(K  key,
             V  value)

지정된 값과 지정된 키를 이 맵에 관련짓습니다. 맵이 이전에 이 키의 매핑을 보관 유지하고 있었을 경우, 낡은 값을 옮겨놓을 수 있습니다.

정의:

인터페이스 Map <K, V > 내의 put

오버라이드(override):

클래스 AbstractMap <K, V > 내의 put

파라미터:

key - 지정되는 값을 관련된 키

value - 지정되는 키에 관련된 값

반환값:

지정된 키에 관련한 값. 또는 키의 매핑이 없었던 경우는 null. 반환값 null는 맵이 이전에 null와 지정된 키를 관련짓고 있던 것을 나타내는 경우도 있다

예외:

ClassCastException - 키가 맵내에 현재 있는 키와 비교할 수 없는 경우

NullPointerException - 키가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

remove

public V  remove(Object  key)

키의 매핑이 있으면 TreeMap 로부터 삭제합니다.

정의:

인터페이스 Map <K, V > 내의 remove

오버라이드(override):

클래스 AbstractMap <K, V > 내의 remove

파라미터:

key - 매핑을 삭제할 필요가 있는 키

반환값:

지정된 키에 관련한 값. 또는 키의 매핑이 없었던 경우는 null. 반환값 null는 맵이 이전에 null와 지정된 키를 관련짓고 있던 것을 나타내는 경우도 있다

예외:

ClassCastException - 키가 맵내에 현재 있는 키와 비교할 수 없는 경우

NullPointerException - 키가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

clear

public void clear()

TreeMap 로부터 모든 매핑을 삭제합니다.

정의:

인터페이스 Map <K, V > 내의 clear

오버라이드(override):

클래스 AbstractMap <K, V > 내의 clear

clone

public Object  clone()

TreeMap 인스턴스의 샤로코피를 리턴합니다. 그 키와 값은 복제되지 않습니다.

오버라이드(override):

클래스 AbstractMap <K, V > 내의 clone

반환값:

이 Map 샤로코피

관련 항목:

Cloneable

keySet

public Set <K > keySet()

맵내에 보관 유지되고 있는 키의 Set 뷰를 리턴합니다. 세트의 반복자는 키를 승순으로 리턴합니다. 맵은 TreeMap 인스턴스에 근거하고 있어 맵에의 변경은 Set에 반영되어 그 역의 경우도 같습니다. Set는 요소의 삭제를 지원 합니다. 이 삭제에서는 Iterator.remove, Set.remove, removeAll, retainAll, clear 각 오퍼레이션을 사용해 대응하는 매핑을 맵으로부터 삭제합니다. Set는 add 오퍼레이션이나 addAll 오퍼레이션은 지원 하고 있습니다.

정의:

인터페이스 Map <K, V > 내의 keySet

오버라이드(override):

클래스 AbstractMap <K, V > 내의 keySet

반환값:

TreeMap에 포함되어 있는 키의 셋트뷰

values

public Collection <V > values()

맵내에 보관 유지되고 있는 값의 코레크션뷰를 리턴합니다. 컬렉션의 반복자는 각 치를 대응하는 키가 트리에 표시되는 순서로 리턴합니다. 컬렉션은 TreeMap 인스턴스에 근거하고 있어 맵에의 변경은 컬렉션에 반영되어 그 역도 같습니다. 컬렉션은 요소의 삭제를 지원 합니다. 이 삭제에서는 Iterator.remove, Collection.remove, removeAll, retainAll, clear 각 오퍼레이션을 사용해 대응하는 매핑을 맵으로부터 삭제합니다. 컬렉션은, add 오퍼레이션이나 addAll 오퍼레이션은 지원 하고 있습니다.

정의:

인터페이스 Map <K, V > 내의 values

오버라이드(override):

클래스 AbstractMap <K, V > 내의 values

반환값:

맵내에 포함되어 있는 값의 코레크션뷰

entrySet

public Set <Map.Entry <K,
V >> entrySet()

맵내에 보관 유지되고 있는 매핑의 셋트뷰를 리턴합니다. 세트의 반복자는 매핑을 키의 승순으로 리턴합니다. 리턴된 세트의 각 요소는 Map.Entry 입니다. 세트는 이 맵에 근거하고 있어 맵에의 변경은 세트에 반영되어 그 역도 같습니다. 세트는 요소의 삭제를 지원 합니다. 이 삭제에서는 Iterator.remove, Set.remove, removeAll, retainAll, clear 각 오퍼레이션을 사용해 대응하는 매핑을 TreeMap 로부터 삭제합니다. Set는 add 오퍼레이션이나 addAll 오퍼레이션은 지원 하고 있습니다.

정의:

인터페이스 Map <K, V > 내의 entrySet

정의:

클래스 AbstractMap <K, V > 내의 entrySet

반환값:

맵내에 보관 유지되고 있는 매핑의 셋트뷰

관련 항목:

Map.Entry

subMap

public SortedMap <K,
V > subMap(K  fromKey,
                             K  toKey)

맵의 fromKey (이것을 포함한다) ~ toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰를 리턴합니다. fromKey와 toKey가 동일한 경우는 비어있는 소트 맵이 리턴됩니다 . 리턴된 소트 맵은 맵에 근거하고 있어 리턴된 소트 맵에서의 변경은 맵에 반영되어 그 역의 경우도 같습니다. 리턴된 소트 맵은 맵의 옵션의 오퍼레이션을 모두 지원 합니다.

이 메서드가 돌려주는 소트 맵은 사용자가 fromKey 보다 작은 키 또는 toKey와 같은가 이것보다 큰 키를 삽입하려고 하면 IllegalArgumentException을 Throw 합니다.

주: 이 메서드는 항상, 그 하단점은 포함하지만 상단점은 포함하지 않는 「한쪽 편이 열린 범위」를 리턴합니다. 상하단점을 포함한 「닫은 범위」가 필요해, 키의 형태에 의해 직후의 키가 계산 가능하게 되는 경우, 단지 lowEndpoint ~ successor(highEndpoint) 부분 범위를 지정해 주세요. 예를 들어, m가 캐릭터 라인의 키를 가지는 소트 맵인 경우, 다음의 관용법은 키가 low ~ high 범위 (상하단점을 포함한다)에 있는 m 내의 모든 키와 값의 매핑을 보관 유지하는 뷰를 취득합니다.

    SortedMap sub = m.submap(low, high+"\0");

같은 테크닉을 사용해, 상하단점의 어느쪽이나 포함하지 않는 「연 범위」를 생성할 수 있습니다. 다음의 관용법은 키가 low ~ high 범위 (상하단점을 포함하지 않는다)에 있는 m 내의 모든 키와 값의 매핑을 보관 유지하는 뷰를 취득합니다.

    SortedMap sub = m.subMap(low+"\0", high);

정의:

인터페이스 SortedMap <K, V > 내의 subMap

파라미터:

fromKey - subMap 하단점 (이것을 포함한다)

toKey - subMap 상단점 (이것을 포함하지 않는다)

반환값:

맵의 fromKey (이것을 포함한다)로부터 toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰

예외:

ClassCastException - 맵의 컴퍼레이터를 사용해, fromKey와 toKey를 서로 비교할 수 없는 경우 (또는 맵에 자연 순서부를 사용하는 컴퍼레이터가 없는 경우)

IllegalArgumentException - fromKey가 toKey 보다 큰 경우

NullPointerException - fromKey 또는 toKey가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

headMap

public SortedMap <K,
V > headMap(K  toKey)

맵의 toKey 보다 작은 키를 가지는 부분의 뷰를 리턴합니다. 리턴된 소트 맵은 맵에 근거하고 있어 리턴된 소트 맵에서의 변경은 이 맵에 반영되어 그 역의 경우도 같습니다. 리턴된 소트 맵은 맵의 옵션의 오퍼레이션을 모두 지원 합니다.

이 메서드가 돌려주는 소트 맵은 사용자가 toKey와 같은가 이것보다 큰 키를 삽입하려고 하면 IllegalArgumentException을 Throw 합니다.

주: 이 메서드는 항상, 그 (상)단점을 포함하지 않는 뷰를 리턴합니다. 이 단 점을 포함한 뷰를 필요로 해, 키의 형태에 의해 직후의 키가 계산 가능하게 되는 경우, 키는 단지 successor(highEndpoint)에 의해 한계를 설치된 headMap를 지정해 주세요. 예를 들어, m가 캐릭터 라인의 키를 가지는 소트 맵인 경우, 다음의 관용법은 키가 high와 같은가 이것보다 작은 m 내의 모든 키치 매핑을 보관 유지하는 뷰를 취득합니다.

     SortedMap head = m.headMap(high+"\0");
 

정의:

인터페이스 SortedMap <K, V > 내의 headMap

파라미터:

toKey - headMap 상단점 (이것을 포함하지 않는다)

반환값:

맵의 toKey 보다 작은 키를 가지는 부분의 뷰

예외:

ClassCastException - toKey가 맵의 컴퍼레이터와 호환성이 없는 경우 (또는 맵에 컴퍼레이터가 없는 경우, toKey에 Comparable가 구현되어 있지 않은 경우)

IllegalArgumentException - 이 맵 자체가 subMap, headMap, 또는 tailMap 로toKey가 지정한 범위의 subMap, headMap, 또는 tailMap에 없는 경우

NullPointerException - toKey가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때

tailMap

public SortedMap <K,
V > tailMap(K  fromKey)

맵의 fromKey 이상의 키를 가지는 부분의 뷰를 리턴합니다. 리턴된 소트 맵은 맵에 근거하고 있어 리턴된 소트 맵에서의 변경은 맵에 반영되어 그 역의 경우도 같습니다. 리턴된 소트 맵은 맵의 옵션의 오퍼레이션을 모두 지원 합니다.

이 메서드가 돌려주는 소트 맵은 사용자가 fromKey 보다 작은 키를 삽입하려고 하면 IllegalArgumentException을 Throw 합니다.

주: 이 메서드는 항상, 그 (하)단점을 포함한 뷰를 리턴합니다. 이 단 점을 포함하지 않는 뷰를 필요로 해, 요소의 형태에 의해 직후의 요소의 계산이 가능한 경우, 단지 successor(lowEndpoint)에 의해 한계를 설치된 tailMap를 지정해 주세요. 예를 들어, m는 그 키가 캐릭터 라인의 소트 맵인 경우, 다음의 관용법은 키가 low 보다 큰 m 내의 모든 키와 값의 매핑을 보관 유지하는 뷰를 취득합니다.

     SortedMap tail = m.tailMap(low+"\0");
 

정의:

인터페이스 SortedMap <K, V > 내의 tailMap

파라미터:

fromKey - tailMap 하단점 (이것을 포함한다)

반환값:

맵의 fromKey와 같은가 이것보다 큰 키를 가지는 부분의 뷰

예외:

ClassCastException - fromKey가 맵의 컴퍼레이터와 호환성이 없는 경우 (또는 맵에 컴퍼레이터가 없는 경우, fromKey에 Comparable가 구현되어 있지 않은 경우)

IllegalArgumentException - 이 맵 자체가 subMap, headMap, 또는 tailMap 로fromKey가 지정한 범위의 subMap, headMap, 또는 tailMap에 없는 경우

NullPointerException - fromKey가 null인 경우에 맵이 자연 순서부를 사용할 때, 혹은 그 컴퍼레이터가 null 키를 허용 하지 않을 때