ConcurrentNavigableMap (Java Platform SE 8)

型パラメータ:

K - このマップで保持されるキーの型

V - マップされる値の型

すべてのスーパー・インタフェース:

ConcurrentMap<K,V>, Map<K,V>, NavigableMap<K,V>, SortedMap<K,V>

既知のすべての実装クラス:

ConcurrentSkipListMap
```
public interface ConcurrentNavigableMap<K,V>
extends ConcurrentMap<K,V>, NavigableMap<K,V>
```
NavigableMapオペレーションをサポートするConcurrentMapです。そのナビゲート可能なサブマップに対しては再帰的です。
このインタフェースは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

1.6

ネストされたクラスのサマリー
- インタフェース java.util.Mapから継承されたネストされたクラス/インタフェース
  Map.Entry<K,V>

メソッドのサマリー

すべてのメソッドインスタンス・メソッド抽象メソッド
修飾子と型	メソッド	説明
`NavigableSet<K>`	`descendingKeySet()`	このマップに含まれるキーの逆順の`NavigableSet`ビューを返します。
`ConcurrentNavigableMap<K,V>`	`descendingMap()`	このマップ内に保持されているマッピングの逆順のビューを返します。
`ConcurrentNavigableMap<K,V>`	`headMap(K toKey)`	このマップの`toKey`よりも確実に小さいキーを持つ部分のビューを返します。
`ConcurrentNavigableMap<K,V>`	`headMap(K toKey, boolean inclusive)`	このマップの`toKey`よりも小さいキー(`inclusive`がtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。
`NavigableSet<K>`	`keySet()`	このマップに含まれるキーの`NavigableSet`ビューを返します。
`NavigableSet<K>`	`navigableKeySet()`	このマップに含まれるキーの`NavigableSet`ビューを返します。
`ConcurrentNavigableMap<K,V>`	`subMap(K fromKey, boolean fromInclusive, K toKey, boolean toInclusive)`	このマップの`fromKey` - `toKey`のキー範囲を持つ部分のビューを返します。
`ConcurrentNavigableMap<K,V>`	`subMap(K fromKey, K toKey)`	このマップの`fromKey` (これを含む) - `toKey` (これを含まない)のキー範囲を持つ部分のビューを返します。
`ConcurrentNavigableMap<K,V>`	`tailMap(K fromKey)`	このマップの`fromKey`以上のキーを持つ部分のビューを返します。
`ConcurrentNavigableMap<K,V>`	`tailMap(K fromKey, boolean inclusive)`	このマップの`fromKey`よりも大きいキー(`inclusive`がtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。

インタフェース java.util.concurrent.ConcurrentMapから継承されたメソッド
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

インタフェース java.util.NavigableMapから継承されたメソッド
ceilingEntry, ceilingKey, firstEntry, floorEntry, floorKey, higherEntry, higherKey, lastEntry, lowerEntry, lowerKey, pollFirstEntry, pollLastEntry

インタフェース java.util.SortedMapから継承されたメソッド
comparator, entrySet, firstKey, lastKey, values

インタフェース java.util.Mapから継承されたメソッド
clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

- メソッドの詳細
  - subMap
```
ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                   boolean fromInclusive,
                                   K toKey,
                                   boolean toInclusive)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのfromKey - toKeyのキー範囲を持つ部分のビューを返します。 fromKeyとtoKeyが等しい場合、返されるマップは、fromInclusiveとtoInclusiveの両方がtrueでないかぎり、空になります。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとしたり、端点のいずれかがその範囲外にあるようなサブマップが構築されようとしたりすると、IllegalArgumentExceptionをスローします。
    
    定義:
    
    subMap、インタフェースNavigableMap<K,V>
    
    パラメータ:
    
    fromKey - 返されるマップ内のキーの下端点
    
    fromInclusive - 返されるビューに下端点が含まれる場合はtrue
    
    toKey - 返されるマップ内のキーの上端点
    
    toInclusive - 返されるビューに上端点が含まれる場合はtrue
    
    戻り値:
    
    このマップのfromKey - toKeyのキー範囲を持つ部分のビュー
    
    例外:
    
    ClassCastException - このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - fromKeyまたはtoKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合
  - headMap
```
ConcurrentNavigableMap<K,V> headMap(K toKey,
                                    boolean inclusive)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
    
    定義:
    
    headMap、インタフェースNavigableMap<K,V>
    
    パラメータ:
    
    toKey - 返されるマップ内のキーの上端点
    
    inclusive - 返されるビューに上端点が含まれる場合はtrue
    
    戻り値:
    
    このマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビュー
    
    例外:
    
    ClassCastException - toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - toKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合
  - tailMap
```
ConcurrentNavigableMap<K,V> tailMap(K fromKey,
                                    boolean inclusive)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
    
    定義:
    
    tailMap、インタフェースNavigableMap<K,V>
    
    パラメータ:
    
    fromKey - 返されるマップ内のキーの下端点
    
    inclusive - 返されるビューに下端点が含まれる場合はtrue
    
    戻り値:
    
    このマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビュー
    
    例外:
    
    ClassCastException - fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - fromKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合
  - subMap
```
ConcurrentNavigableMap<K,V> subMap(K fromKey,
                                   K toKey)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのfromKey (これを含む) - toKey (これを含まない)のキー範囲を持つ部分のビューを返します。 fromKeyとtoKeyが等しい場合は、空のマップが返されます。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
    subMap(fromKey, true, toKey, false)と同等です。
    
    定義:
    
    subMap、インタフェースNavigableMap<K,V>
    
    定義:
    
    subMap、インタフェースSortedMap<K,V>
    
    パラメータ:
    
    fromKey - 返されるマップ内のキーの下端点(これを含む)
    
    toKey - 返されるマップ内のキーの上端点(これを含まない)
    
    戻り値:
    
    このマップのfromKey (これを含む) - toKey (これを含まない)のキー範囲を持つ部分のビュー
    
    例外:
    
    ClassCastException - このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - fromKeyまたはtoKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合
  - headMap
```
ConcurrentNavigableMap<K,V> headMap(K toKey)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのtoKeyよりも確実に小さいキーを持つ部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
    headMap(toKey, false)と同等です。
    
    定義:
    
    headMap、インタフェースNavigableMap<K,V>
    
    定義:
    
    headMap、インタフェースSortedMap<K,V>
    
    パラメータ:
    
    toKey - 返されるマップ内のキーの上端点(これを含まない)
    
    戻り値:
    
    このマップのtoKeyよりも確実に小さいキーを持つ部分のビュー
    
    例外:
    
    ClassCastException - toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - toKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合
  - tailMap
```
ConcurrentNavigableMap<K,V> tailMap(K fromKey)
```
    インタフェースからコピーされた説明: NavigableMap
    
    このマップのfromKey以上のキーを持つ部分のビューを返します。返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。返されるマップは、このマップがサポートする任意のマップ・オペレーションをすべてサポートします。
    返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。
    tailMap(fromKey, true)と同等です。
    
    定義:
    
    tailMap、インタフェースNavigableMap<K,V>
    
    定義:
    
    tailMap、インタフェースSortedMap<K,V>
    
    パラメータ:
    
    fromKey - 返されるマップ内のキーの下端点(これを含む)
    
    戻り値:
    
    このマップのfromKey以上のキーを持つ部分のビュー
    
    例外:
    
    ClassCastException - fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローすることができる。ただし、必須ではない。
    
    NullPointerException - fromKeyがnullであり、このマップがnullキーを許可しない場合
    
    IllegalArgumentException - このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合
  - descendingMap
```
ConcurrentNavigableMap<K,V> descendingMap()
```
    このマップ内に保持されているマッピングの逆順のビューを返します。降順マップはこのマップに連動しており、このマップでの変更は降順マップに反映され、その逆の場合も同様です。
    返されるマップの順序付けは、Collections.reverseOrder(comparator())と同等になります。式m.descendingMap().descendingMap()から返されるmのビューは基本的にmと同等になります。
    
    定義:
    
    descendingMap、インタフェースNavigableMap<K,V>
    
    戻り値:
    
    このマップの逆順のビュー
  - navigableKeySet
```
NavigableSet<K> navigableKeySet()
```
    このマップに含まれるキーのNavigableSetビューを返します。セットのイテレータは、キーを昇順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。 addまたはaddAllオペレーションはサポートされていません。
    ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
    
    定義:
    
    navigableKeySet、インタフェースNavigableMap<K,V>
    
    戻り値:
    
    このマップ内のキーのナビゲート可能なセット・ビュー
  - keySet
```
NavigableSet<K> keySet()
```
    このマップに含まれるキーのNavigableSetビューを返します。セットのイテレータは、キーを昇順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。 addまたはaddAllオペレーションはサポートされていません。
    ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
    このメソッドは、メソッドnavigableKeySetと同等です。
    
    定義:
    
    keySet、インタフェースMap<K,V>
    
    定義:
    
    keySet、インタフェースSortedMap<K,V>
    
    戻り値:
    
    このマップ内のキーのナビゲート可能なセット・ビュー
  - descendingKeySet
```
NavigableSet<K> descendingKeySet()
```
    このマップに含まれるキーの逆順のNavigableSetビューを返します。セットのイテレータは、キーを降順で返します。セットはマップと連動しているので、マップに対する変更はセットに反映され、また、セットに対する変更はマップに反映されます。セットは要素の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。 addまたはaddAllオペレーションはサポートされていません。
    ビューのイテレータおよびスプリッテレータは、弱一貫性を持っています。
    
    定義:
    
    descendingKeySet、インタフェースNavigableMap<K,V>
    
    戻り値:
    
    このマップ内のキーのナビゲート可能な逆順セット・ビュー

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

インタフェースConcurrentNavigableMap<K,V>

ネストされたクラスのサマリー

インタフェース java.util.Mapから継承されたネストされたクラス/インタフェース

メソッドのサマリー

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

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

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

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

メソッドの詳細

subMap

headMap

tailMap

subMap

headMap

tailMap

descendingMap

navigableKeySet

keySet

descendingKeySet