java.util
인터페이스 NavigableMap<K, V>

형태 파라미터:

K - 이 맵이 보관 유지하는 키의 형태

V - 맵 되는 값의 형태

모든 슈퍼 인터페이스:

Map <K, V>, SortedMap <K, V>

기존의 서브 인터페이스의 일람:

ConcurrentNavigableMap <K, V>

기존의 구현 클래스의 일람:

ConcurrentSkipListMap , TreeMap

public interface NavigableMap<K, V>
extends SortedMap <K, V>

지정된 타겟으로 가장 가까운 요소를 돌려주는 네비게이션 메소드로 확장된 SortedMap 입니다. lowerEntry,floorEntry,ceilingEntry,higherEntry 메소드는 각각, 지정된 키보다 작은 키, 작은가 동일한 키, 큰가 동일한 키, 큰 키에 관련지을 수 있었던 Map.Entry 객체를 돌려줍니다. 다만, 그러한 키가 존재하지 않는 경우는 null 를 돌려줍니다. 같이lowerKey,floorKey,ceilingKey, 및 higherKey 메소드는, 관련하는 키만을 돌려줍니다. 이러한 모든 메소드의 설계 목적은, 엔트리를 횡단(traverse) 하는 것은 아니고, 엔트리를 특정하는 것입니다.

NavigableMap 에의 액세스나 횡단(traverse)은, 키의 승순, 내림차순의 어느쪽이든으로 실시할 수 있습니다. descendingMap 메소드로부터 반환되는 이 맵의 뷰에서는, 관계나 방향에 관한 메소드가 모두 반전되었는지와 같이 느껴집니다. 오퍼레이션이나 뷰의 퍼포먼스는 일반적으로, 내림차순보다 승순 쪽이 고속으로 됩니다. subMap,headMap, 및 tailMap 메소드는, 하한과 상한을 포함할지 어떨지를 기술하는 추가의 인수를 받는다고 하는 점으로써,SortedMap 의 유사한 이름을 가지는 메소드와는 다릅니다. 임의의 NavigableMap 의 서브 맵은,NavigableMap 인터페이스를 구현합니다.

이 인터페이스에는 게다가firstEntry,pollFirstEntry,lastEntry, 및 pollLastEntry 메소드도 정의되고 있습니다. 이러한 메소드는, 최소, 최대의 매핑이 존재하는 경우는 그 리턴 또는 삭제, 혹은 그 양쪽 모두를 실시해, 그 이외의 경우는 null 를 돌려줍니다.

엔트리를 돌려주는 메소드의 구현은, 매핑의 생성 시점에서의 snapshot를 나타내는 Map.Entry 페어를 돌려주는 것을 기대되기 (위해)때문에, 일반적으로은 생략 가능한 Entry.setValue 메소드를 지원하지 않습니다. 다만, 관련하는 맵내의 매핑은 put 메소드를 사용해 변경할 수 있는 것에 주의해 주세요.

subMap(K, K) ,headMap(K) , 및 tailMap(K) 가 SortedMap 메소드를 돌려주는 스펙이 되어 있는 것은, 기존의 SortedMap 구현을 호환성을 유지하면서 개량해 NavigableMap 를 구현할 수 있도록(듯이) 하기 (위해)때문에입니다. 다만, 이 인터페이스의 확장이나 구현에서는, 이러한 메소드를 오버라이드(override) 해 NavigableMap 가 돌려주어지도록(듯이) 하는 것을 추천합니다. 같이SortedMap.keySet() 를 오버라이드(override) 해 NavigableSet 가 돌려주어지도록(듯이) 할 수도 있습니다.

이 인터페이스는,Java Collections Framework 의 멤버입니다.

도입된 버젼:

1.6

상자의 클래스의 개요

인터페이스 java.util. Map 로부터 상속된 상자의 클래스/인터페이스

Map.Entry <K ,V >

메소드의 개요

Map.Entry <K ,V >	ceilingEntry (K key) 지정된 키와 동일한가 그것보다 큰 키 속에서 최소의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다.
K	ceilingKey (K key) 지정된 키와 동일한가 그것보다 큰 키 속에서 최소의 것을 돌려줍니다.
NavigableSet <K >	descendingKeySet () 이 맵에 포함되는 키의 역순서 NavigableSet 뷰를 돌려줍니다.
NavigableMap <K ,V >	descendingMap () 맵내에 보관 유지되고 있는 매핑의 역순서의 뷰를 돌려줍니다.
Map.Entry <K ,V >	firstEntry () 이 맵내에서 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다.
Map.Entry <K ,V >	floorEntry (K key) 지정된 키와 동일한가 그것보다 작은 키 속에서 최대의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다.
K	floorKey (K key) 지정된 키와 동일한가 그것보다 작은 키 속에서 최대의 것을 돌려줍니다.
SortedMap <K ,V >	headMap (K toKey) 맵의 toKey 보다 작은 키를 가지는 부분의 뷰를 돌려줍니다.
NavigableMap <K ,V >	headMap (K toKey, boolean inclusive) toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다.
Map.Entry <K ,V >	higherEntry (K key) 지정된 키보다 확실히 큰 키 속에서 최소의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다.
K	higherKey (K key) 지정된 키보다 확실히 큰 키 속에서 최소의 것을 돌려줍니다.
Map.Entry <K ,V >	lastEntry () 이 맵내에서 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다.
Map.Entry <K ,V >	lowerEntry (K key) 지정된 키보다 확실히 작은 키 속에서 최대의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다.
K	lowerKey (K key) 지정된 키보다 확실히 작은 키 속에서 최대의 것을 돌려줍니다.
NavigableSet <K >	navigableKeySet () 이 맵에 포함되는 키 NavigableSet 뷰를 돌려줍니다.
Map.Entry <K ,V >	pollFirstEntry () 이 맵내에서 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해 돌려줍니다.
Map.Entry <K ,V >	pollLastEntry () 이 맵내에서 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해 돌려줍니다.
NavigableMap <K ,V >	subMap (K fromKey, boolean fromInclusive, K toKey, boolean toInclusive) 맵의 fromKey ~ toKey 의 키 범위를 가지는 부분의 뷰를 돌려줍니다.
SortedMap <K ,V >	subMap (K fromKey, K toKey) 맵의 fromKey (이것을 포함한다) ~ toKey (이것을 포함하지 않는다)의 키 범위를 가지는 부분의 뷰를 돌려줍니다.
SortedMap <K ,V >	tailMap (K fromKey) 맵의 fromKey 이상의 키를 가지는 부분의 뷰를 돌려줍니다.
NavigableMap <K ,V >	tailMap (K fromKey, boolean inclusive) fromKey 보다 큰 키 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰를 돌려줍니다.

인터페이스 java.util. SortedMap 로부터 상속된 메소드

comparator , entrySet , firstKey , keySet , lastKey , values

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

clear , containsKey , containsValue , equals , get , hashCode , isEmpty , put , putAll , remove , size

메소드의 상세

lowerEntry

Map.Entry <K ,V > lowerEntry(K  key)

지정된 키보다 확실히 작은 키 속에서 최대의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다. 그러한 키가 존재하지 않는 경우는 null 를 돌려줍니다.

파라미터:

key - 키

반환값:

key 보다 작은 키 속에서 최대의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

lowerKey

K  lowerKey(K  key)

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

파라미터:

key - 키

반환값:

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

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

floorEntry

Map.Entry <K ,V > floorEntry(K  key)

지정된 키와 동일한가 그것보다 작은 키 속에서 최대의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다. 그러한 키가 존재하지 않는 경우는 null 를 돌려줍니다.

파라미터:

key - 키

반환값:

key 와 동일한가 그것보다 작은 키 속에서 최대의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

floorKey

K  floorKey(K  key)

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

파라미터:

key - 키

반환값:

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

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

ceilingEntry

Map.Entry <K ,V > ceilingEntry(K  key)

지정된 키와 동일한가 그것보다 큰 키 속에서 최소의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다. 그러한 키가 존재하지 않는 경우는 null 를 돌려줍니다.

파라미터:

key - 키

반환값:

key 와 동일한가 그것보다 큰 키 속에서 최소의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

ceilingKey

K  ceilingKey(K  key)

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

파라미터:

key - 키

반환값:

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

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

higherEntry

Map.Entry <K ,V > higherEntry(K  key)

지정된 키보다 확실히 큰 키 속에서 최소의 것에 관련지을 수 있던, 키와 값의 매핑을 돌려줍니다. 그러한 키가 존재하지 않는 경우는 null 를 돌려줍니다.

파라미터:

key - 키

반환값:

key 보다 큰 키 속에서 최소의 것을 가지는 엔트리. 그러한 키가 존재하지 않는 경우는 null

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

higherKey

K  higherKey(K  key)

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

파라미터:

key - 키

반환값:

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

예외:

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

NullPointerException - 지정된 키가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

firstEntry

Map.Entry <K ,V > firstEntry()

이 맵내에서 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. 이 맵이 빈 상태(empty)의 경우는 null 를 돌려줍니다.

반환값:

최소의 키를 가지는 엔트리. 이 맵이 빈 상태(empty)의 경우는 null

lastEntry

Map.Entry <K ,V > lastEntry()

이 맵내에서 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 돌려줍니다. 이 맵이 빈 상태(empty)의 경우는 null 를 돌려줍니다.

반환값:

최대의 키를 가지는 엔트리. 이 맵이 빈 상태(empty)의 경우는 null

pollFirstEntry

Map.Entry <K ,V > pollFirstEntry()

이 맵내에서 최소의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해 돌려줍니다. 이 맵이 빈 상태(empty)의 경우는 null 를 돌려줍니다.

반환값:

이 맵의 삭제된 최초의 엔트리. 이 맵이 빈 상태(empty)의 경우는 null

pollLastEntry

Map.Entry <K ,V > pollLastEntry()

이 맵내에서 최대의 키에 관련지을 수 있었던 키와 값의 매핑을 삭제해 돌려줍니다. 이 맵이 빈 상태(empty)의 경우는 null 를 돌려줍니다.

반환값:

이 맵의 삭제된 마지막 엔트리. 이 맵이 빈 상태(empty)의 경우는 null

descendingMap

NavigableMap <K ,V > descendingMap()

맵내에 보관 유지되고 있는 매핑의 역순서의 뷰를 돌려줍니다. 내림차순 맵은 이 맵에 연동하고 있어, 이 맵에서의 변경은 내림차순 맵에 반영되어 그 역의 경우도 같습니다. 몇개의 맵의 코레크션뷰의 반복 처리중에 몇개의 맵이 변경되었을 경우, 반복 처리의 결과는 정의되지 않습니다 (반복자 자신의 remove 오퍼레이션을 제외하다).

반환된 맵의 순서부는,Collections.reverseOrder (comparator()) 와 등가가 됩니다. 식 m.descendingMap(). descendingMap() 로부터 반환되는 m 의 뷰는 기본적으로,m 와 등가가 됩니다.

반환값:

이 맵의 역순서의 뷰

navigableKeySet

NavigableSet <K > navigableKeySet()

이 맵에 포함되는 키 NavigableSet 뷰를 돌려줍니다. 세트의 반복자는, 키를 승순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트의 반복 처리중으로 맵이 변경되었을 경우, 반복 처리의 결과는 정의되지 않습니다 (반복자 자신의 remove 오퍼레이션을 제외하다). 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. add 및 addAll 오퍼레이션은 지원되지 않습니다.

반환값:

이 맵내의 키의 안내 가능한 셋트뷰

descendingKeySet

NavigableSet <K > descendingKeySet()

이 맵에 포함되는 키의 역순서 NavigableSet 뷰를 돌려줍니다. 세트의 반복자는, 키를 내림차순으로 돌려줍니다. 세트는 맵과 연동하고 있으므로, 맵에 대한 변경은 세트에 반영되어 또, 세트에 대한 변경은 맵에 반영됩니다. 세트의 반복 처리중으로 맵이 변경되었을 경우, 반복 처리의 결과는 정의되지 않습니다 (반복자 자신의 remove 오퍼레이션을 제외하다). 세트는 요소의 삭제를 지원하고 있어, 대응하는 매핑을 맵으로부터 삭제할 수가 있습니다. 삭제는,Iterator.remove,Set.remove,removeAll,retainAll, 및 clear 의 각 오퍼레이션을 통해 실시합니다. add 및 addAll 오퍼레이션은 지원되지 않습니다.

반환값:

이 맵내의 키의 안내 가능한 역순서 셋트뷰

subMap

NavigableMap <K ,V > subMap(K  fromKey,
                         boolean fromInclusive,
                         K  toKey,
                         boolean toInclusive)

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하거나 단 점중 한쪽이 그 범위외에 있는 것 같은 서브 맵이 구축되려고 하거나 하면(자),IllegalArgumentException 를 throw 합니다.

파라미터:

fromKey - 반환되는 맵내의 키의 하단점

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

toKey - 반환되는 맵내의 키의 상단점

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

반환값:

맵의 fromKey ~ toKey 의 키 범위를 가지는 부분의 뷰

예외:

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

NullPointerException - fromKey 또는 toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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

headMap

NavigableMap <K ,V > headMap(K  toKey,
                          boolean inclusive)

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

파라미터:

toKey - 반환되는 맵내의 키의 상단점

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

반환값:

toKey 보다 작은 키 (inclusive 가 true 의 경우는 그것보다 작은가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰

예외:

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

NullPointerException - toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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

tailMap

NavigableMap <K ,V > tailMap(K  fromKey,
                          boolean inclusive)

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

파라미터:

fromKey - 반환되는 맵내의 키의 하단점

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

반환값:

fromKey 보다 큰 키 (inclusive 가 true 의 경우는 그것보다 큰가 그것과 동일한 키)를 포함한 이 맵의 부분의 뷰

예외:

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

NullPointerException - fromKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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

subMap

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

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

subMap(fromKey, true, toKey, false) 와 등가입니다.

정의:

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

파라미터:

fromKey - 반환되는 맵내의 키의 하단점 (이것을 포함한다)

toKey - 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)

반환값:

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

예외:

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

NullPointerException - fromKey 또는 toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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

headMap

SortedMap <K ,V > headMap(K  toKey)

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

headMap(toKey, false) 와 등가입니다.

정의:

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

파라미터:

toKey - 반환되는 맵내의 키의 상단점 (이것을 포함하지 않는다)

반환값:

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

예외:

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

NullPointerException - toKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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

tailMap

SortedMap <K ,V > tailMap(K  fromKey)

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

반환되는 맵은, 그 범위외의 키가 삽입되려고 하면(자),IllegalArgumentException 를 throw 합니다.

tailMap(fromKey, true) 와 등가입니다.

정의:

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

파라미터:

fromKey - 반환되는 맵내의 키의 하단점 (이것을 포함한다)

반환값:

맵의 fromKey 이상의 키를 가지는 부분의 뷰

예외:

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

NullPointerException - fromKey 가 null 이며, 이 맵이 null 키를 허가하지 않는 경우

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