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

型パラメータ:
K - このマップによって保持されるキーのタイプ
V - マップされた値のタイプ
すべてのスーパー・インタフェース:
Map<K,V>, SequencedMap<K,V>, SortedMap<K,V>
既知のすべてのサブインタフェース:
ConcurrentNavigableMap<K,V>
既知のすべての実装クラス:
ConcurrentSkipListMap, TreeMap
public interface NavigableMap<K,V> extends SortedMap<K,V>
指定の検索ターゲットにもっとも近い一致内容を返すナビゲーション・メソッドで拡張されたSortedMapです。 メソッドlowerEntry(K)、floorEntry(K)、ceilingEntry(K)およびhigherEntry(K)は、指定されたキーより小さい、小さいまたは等しい、大きいまたは大きい、および大きいキーに関連付けられているMap.Entryオブジェクトを返し、そのようなキーがない場合はnullを返します。 同様に、メソッドlowerKey(K)、floorKey(K)、ceilingKey(K)およびhigherKey(K)は、関連付けられたキーのみを返します。 これらのすべてのメソッドの設計目的は、エントリをトラバースすることではなく、エントリを特定することです。

NavigableMapへのアクセスやトラバースは、キーの昇順、降順のいずれかで行えます。 descendingMap()メソッドは、すべてのリレーショナル・メソッドと方向メソッドの感覚を反転させたマップのビューを返します。 オペレーションやビューのパフォーマンスは通常、降順よりも昇順のほうが高速になります。 メソッドsubMap(K, boolean, K, boolean)、headMap(K, boolean)およびtailMap(K, boolean)は、下限と上限が包含的か排他的かを記述する追加の引数を受け入れる際の、同じ名前のSortedMapメソッドとは異なります。 どのNavigableMapのサブマップでもNavigableMapインタフェースを実装する必要があります。

このインタフェースは、メソッドfirstEntry()、pollFirstEntry()、lastEntry()およびpollLastEntry()をさらに定義し、最小および最大のマッピング(存在する場合)を返したり削除したりします。それ以外の場合は、nullを返します。

メソッドceilingEntry(K)、firstEntry()、floorEntry(K)、higherEntry(K)、lastEntry()、lowerEntry(K)、pollFirstEntry()およびpollLastEntry()は、コール時点でのマッピングのスナップショットを表すMap.Entryインスタンスを返します。 オプションのsetValueメソッドを介した基礎となるマップの変更はサポートされていません。

subMap(K, K)、headMap(K)およびtailMap(K)メソッドは、既存のSortedMap実装を互換的に改良してNavigableMapを実装できるようにするために、SortedMapを返すように規定されています。ただし、このインタフェースの拡張および実装は、これらのメソッドをオーバーライドしてNavigableMapを返すようにすることをお薦めします。 同様に、SortedMap.keySet()をオーバーライドしてNavigableSetを返すこともできます。

このインタフェースは、Java Collections Frameworkのメンバーです。

導入されたバージョン:
1.6

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

    インタフェースMapで宣言されたネストされたクラス/インタフェース

    Map.Entry<K,V>
    修飾子と型
    インタフェース
    説明
    static interface 
    Map.Entry<K,V>
    マップのエントリ(キーと値のペア)です。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    Map.Entry<K,V>
    ceilingEntry(K key)
    指定されたキー以上の、最小のキーと関連するキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。
    K
    ceilingKey(K key)
    指定されたキーと等しいかそれよりも大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。
    NavigableSet<K>
    descendingKeySet()
    このマップに含まれるキーの逆順のNavigableSetビューを返します。
    NavigableMap<K,V>
    descendingMap()
    このマップ内に保持されているマッピングの逆順のビューを返します。
    Map.Entry<K,V>
    firstEntry()
    このマップ内の最小のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。
    Map.Entry<K,V>
    floorEntry(K key)
    指定されたキー以下の、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。
    K
    floorKey(K key)
    指定されたキーと等しいかそれよりも小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。
    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)
    指定されたキーよりも確実に大きい、最小のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。
    K
    higherKey(K key)
    指定されたキーよりも確実に大きいキーの中で最小のものを返します。そのようなキーが存在しない場合はnullを返します。
    Map.Entry<K,V>
    lastEntry()
    このマップ内の最大のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。
    Map.Entry<K,V>
    lowerEntry(K key)
    指定されたキーよりも確実に小さい、最大のキーに関連付けられたキーと値のマッピングを返します。そのようなキーが存在しない場合は、nullを返します。
    K
    lowerKey(K key)
    指定されたキーよりも確実に小さいキーの中で最大のものを返します。そのようなキーが存在しない場合はnullを返します。
    NavigableSet<K>
    navigableKeySet()
    このマップに含まれるキーのNavigableSetビューを返します。
    Map.Entry<K,V>
    pollFirstEntry()
    このマップ内の最も小さいキーに関連付けられたキーと値のマッピングを削除して返します。マップが空の(オプションの操作)の場合はnullを返します。
    Map.Entry<K,V>
    pollLastEntry()
    このマップ内の最も大きいキーに関連付けられているキーと値のマッピングを削除して返します。マップが空の(オプションの操作)の場合はnullを返します。
    default NavigableMap<K,V>
    reversed()
    このマップの逆順viewを返します。
    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の場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。

    インタフェースMapで宣言されたメソッド

    clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, equals, forEach, get, getOrDefault, hashCode, isEmpty, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size
    修飾子と型
    メソッド
    説明
    void
    clear()
    マップからマッピングをすべて削除します(オプションの操作)。
    default V
    compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)
    指定されたキーとその現在のマップされた値のマッピングをコンピュートしようとします。現在のマッピング(オプションの操作)がない場合はnullです。
    default V
    computeIfAbsent(K key, Function<? super K, ? extends V> mappingFunction)
    指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、指定されたマッピング関数を使用してその値をコンピュートし、null (オプションの操作)でないかぎりこのマップに入力します。
    default V
    computeIfPresent(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)
    指定されたキーの値が存在し、null以外の場合は、キーとその現在のマップされた値(オプションの操作)を指定して、新しいマッピングのコンピュートを試みます。
    boolean
    containsKey(Object key)
    指定されたキーのマッピングがこのマップに含まれている場合にtrueを返します。
    boolean
    containsValue(Object value)
    このマップが1つまたは複数のキーと指定された値をマッピングしている場合にtrueを返します。
    boolean
    equals(Object o)
    指定されたオブジェクトがこのマップと等しいかどうかを比較します。
    default void
    forEach(BiConsumer<? super K, ? super V> action)
    このマップのすべてのエントリの処理が完了するかアクションから例外がスローされるまで、各エントリに対して指定されたアクションを実行します。
    V
    get(Object key)
    指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない場合はnullを返します。
    default V
    getOrDefault(Object key, V defaultValue)
    指定されたキーがマップされている値を返します。このマップにそのキーのマッピングが含まれていない場合はdefaultValueを返します。
    int
    hashCode()
    マップのハッシュ・コード値を返します。
    boolean
    isEmpty()
    このマップがキーと値のマッピングを保持しない場合にtrueを返します。
    default V
    merge(K key, V value, BiFunction<? super V, ? super V, ? extends V> remappingFunction)
    指定されたキーがまだ値に関連付けられていない場合、またはnullに関連付けられている場合は、指定されたnull以外の値(オプションの操作)に関連付けます。
    V
    put(K key, V value)
    指定された値と指定されたキーをこのマップで関連付けます(オプションの操作)。
    void
    putAll(Map<? extends K, ? extends V> m)
    指定されたマップのすべてのマッピングをこのマップにコピーします(オプションの操作)。
    default V
    putIfAbsent(K key, V value)
    指定されたキーが値(または、nullにマップされます。)にまだ関連付けられていない場合、そのキーは指定された値に関連付けられ、nullを返します。それ以外の場合は、現在の値(オプションの操作)を返します。
    V
    remove(Object key)
    このマップからキーのマッピング(ある場合)を削除します(オプションの操作)。
    default boolean
    remove(Object key, Object value)
    指定されたキーが現在、指定された値(オプションの操作)にマップされている場合にのみ、そのキーのエントリを削除します。
    default V
    replace(K key, V value)
    指定されたキーのエントリが、現在値(オプションの操作)にマップされている場合にのみ、そのエントリを置換します。
    default boolean
    replace(K key, V oldValue, V newValue)
    指定された値(オプションの操作)に現在マップされている場合にのみ、指定されたキーのエントリを置換します。
    default void
    replaceAll(BiFunction<? super K, ? super V, ? extends V> function)
    すべてのエントリが処理されるか、関数が例外(オプションの操作)をスローするまで、各エントリの値を、そのエントリの指定された関数を呼び出した結果に置き換えます。
    int
    size()
    このマップ内のキー値マッピングの数を返します。

    インタフェースで宣言されたメソッド SequencedMap

    sequencedEntrySet, sequencedKeySet, sequencedValues
    修飾子と型
    メソッド
    説明
    default SequencedSet<Map.Entry<K,V>>
    sequencedEntrySet()
    このマップのentrySetのSequencedSetビューを返します。
    default SequencedSet<K>
    sequencedKeySet()
    このマップのkeySetのSequencedSetビューを返します。
    default SequencedCollection<V>
    sequencedValues()
    このマップのvaluesコレクションのSequencedCollectionビューを返します。

    インタフェースで宣言されたメソッド SortedMap

    comparator, entrySet, firstKey, keySet, lastKey, putFirst, putLast, values
    修飾子と型
    メソッド
    説明
    Comparator<? super K>
    comparator()
    このマップ内のキーを順序付けするのに使うコンパレータを返します。ただし、このマップがそのキーの自然順序付けを使う場合はnullを返します。
    Set<Map.Entry<K,V>>
    entrySet()
    このマップに含まれるマッピングのSetビューを返します。
    K
    firstKey()
    マップ内に現在ある最初(下端)のキーを返します。
    Set<K>
    keySet()
    このマップに含まれるキーのSetビューを返します。
    K
    lastKey()
    マップ内に現在ある最後(上端)のキーを返します。
    default V
    putFirst(K k, V v)
    UnsupportedOperationExceptionをスローします。
    default V
    putLast(K k, V v)
    UnsupportedOperationExceptionをスローします。
    Collection<V>
    values()
    このマップに含まれる値のCollectionビューを返します。

  • メソッドの詳細

    • 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()
      このマップ内の最小のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。
      定義:
      インタフェースSequencedMap<K,V>内のfirstEntry
      戻り値:
      最小のキーを持つエントリ。このマップが空の場合はnull

    • lastEntry

      Map.Entry<K,V> lastEntry()
      このマップ内の最大のキーに関連付けられたキーと値のマッピングを返します。マップが空の場合、nullを返します。
      定義:
      インタフェースSequencedMap<K,V>内のlastEntry
      戻り値:
      最大のキーを持つエントリ。このマップが空の場合はnull

    • pollFirstEntry

      Map.Entry<K,V> pollFirstEntry()
      このマップ内の最も小さいキーに関連付けられたキーと値のマッピングを削除して返します。マップが空の(オプションの操作)の場合はnullを返します。
      定義:
      インタフェースSequencedMap<K,V>内のpollFirstEntry
      戻り値:
      このマップの削除された最初のエントリ。このマップが空の場合はnull
      スロー:
      UnsupportedOperationException - このマップでpollFirstEntry操作がサポートされていない場合

    • pollLastEntry

      Map.Entry<K,V> pollLastEntry()
      このマップ内の最も大きいキーに関連付けられているキーと値のマッピングを削除して返します。マップが空の(オプションの操作)の場合はnullを返します。
      定義:
      インタフェースSequencedMap<K,V>内のpollLastEntry
      戻り値:
      このマップの削除された最後のエントリ。このマップが空の場合はnull
      スロー:
      UnsupportedOperationException - このマップでpollLastEntry操作がサポートされていない場合

    • descendingMap

      NavigableMap<K,V> descendingMap()
      このマップ内に保持されているマッピングの逆順のビューを返します。 降順マップはこのマップに連動しており、このマップでの変更は降順マップに反映され、その逆の場合も同様です。 いずれかのマップのコレクション・ビューの反復処理中にいずれかのマップが変更された場合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーションを除く)。

      返されるマップの順序付けは、Collections.reverseOrder(comparator())と同等になります。 式m.descendingMap().descendingMap()から返されるmのビューは基本的にmと同等になります。

      戻り値:
      このマップの逆順のビュー

    • 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が等しい場合、返されるマップは、fromInclusiveとtoInclusiveの両方がtrueでないかぎり、空になります。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとしたり、端点のいずれかがその範囲外にあるようなサブマップが構築されようとしたりすると、IllegalArgumentExceptionをスローします。

      パラメータ:
      fromKey - 返されるマップ内のキーの下端点
      fromInclusive - 返されるビューに下端点が含まれる場合はtrue
      toKey - 返されるマップ内のキーの上端点
      toInclusive - 返されるビューに上端点が含まれる場合はtrue
      戻り値:
      このマップのfromKey - toKeyのキー範囲を持つ部分のビュー
      スロー:
      ClassCastException - このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。 実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromKeyまたはtoKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合

    • headMap

      NavigableMap<K,V> headMap(K toKey, boolean inclusive)
      このマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。

      パラメータ:
      toKey - 返されるマップ内のキーの上端点
      inclusive - 返されるビューに上端点が含まれる場合はtrue
      戻り値:
      このマップのtoKeyよりも小さいキー(inclusiveがtrueの場合はそれよりも小さいかそれと等しいキー)を含む部分のビュー
      スロー:
      ClassCastException - toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない
      NullPointerException - toKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合

    • tailMap

      NavigableMap<K,V> tailMap(K fromKey, boolean inclusive)
      このマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。

      パラメータ:
      fromKey - 返されるマップ内のキーの下端点
      inclusive - 返されるビューに下端点が含まれる場合はtrue
      戻り値:
      このマップのfromKeyよりも大きいキー(inclusiveがtrueの場合はそれよりも大きいかそれと等しいキー)を含む部分のビュー
      スロー:
      ClassCastException - fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない
      NullPointerException - fromKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合

    • subMap

      SortedMap<K,V> subMap(K fromKey, K toKey)
      このマップのfromKey (これを含む) - toKey (これを含まない)のキー範囲を持つ部分のビューを返します。 fromKeyとtoKeyが等しい場合は、空のマップが返されます。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。

      subMap(fromKey, true, toKey, false)と同等です。

      定義:
      インタフェースSortedMap<K,V>内のsubMap
      パラメータ:
      fromKey - 返されるマップ内のキーの下端点(これを含む)
      toKey - 返されるマップ内のキーの上端点(これを含まない)
      戻り値:
      このマップのfromKey (これを含む)からtoKey (これを含まない)のキー範囲を持つ部分のビュー
      スロー:
      ClassCastException - このマップのコンパレータを使用して(このマップがコンパレータを持たない場合は自然順序付けを使用して)、fromKeyとtoKeyを相互に比較できない場合。 実装は、マップ内に現在存在しているキーとfromKeyまたはtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない。
      NullPointerException - fromKeyまたはtoKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - fromKeyがtoKeyよりも大きい場合、またはこのマップ自体が制限された範囲を持っており、fromKeyまたはtoKeyがその範囲から外れている場合

    • headMap

      SortedMap<K,V> headMap(K toKey)
      このマップのtoKeyよりも確実に小さいキーを持つ部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。

      headMap(toKey, false)と同等です。

      定義:
      インタフェースSortedMap<K,V>内のheadMap
      パラメータ:
      toKey - 返されるマップ内のキーの上端点(これを含まない)
      戻り値:
      このマップのtoKeyよりも確実に小さいキーを持つ部分のビュー
      スロー:
      ClassCastException - toKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、toKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとtoKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない
      NullPointerException - toKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - このマップ自体が制限された範囲を持っており、toKeyがその範囲から外れている場合

    • tailMap

      SortedMap<K,V> tailMap(K fromKey)
      このマップのfromKey以上のキーを持つ部分のビューを返します。 返されるマップはこのマップに連動しており、返されるマップでの変更はこのマップに反映され、その逆の場合も同様です。 返されるマップは、このマップがサポートするオプションのマップ・オペレーションをすべてサポートします。

      返されるマップは、その範囲外のキーが挿入されようとすると、IllegalArgumentExceptionをスローします。

      tailMap(fromKey, true)と同等です。

      定義:
      インタフェースSortedMap<K,V>内のtailMap
      パラメータ:
      fromKey - 返されるマップ内のキーの下端点(これを含む)
      戻り値:
      このマップのfromKey以上のキーを持つ部分のビュー
      スロー:
      ClassCastException - fromKeyがこのマップのコンパレータと互換性がない場合(または、そのマップがコンパレータを持たない場合、fromKeyがComparableを実装していない場合)。 実装は、マップ内に現在存在しているキーとfromKeyとを比較できない場合にこの例外をスローできる。ただし、必須ではない
      NullPointerException - fromKeyがnullであり、このマップがnullキーを許可しない場合
      IllegalArgumentException - このマップ自体が制限された範囲を持っており、fromKeyがその範囲から外れている場合

    • reversed

      default NavigableMap<K,V> reversed()
      このマップの逆順viewを返します。 返されるビューでのマッピングの検出順序は、このマップでのマッピングの検出順序の逆です。 逆の順序付けは、返されるビューのビュー・コレクションに含まれるすべての順序依存操作に影響します。 実装でこのビューの変更が許可されている場合は、基礎となるマップに"ライトスルー"が変更されます。 実装によっては、基礎となるマップに対する変更が、この逆方向ビューに表示される場合と表示されない場合があります。

      このメソッドはdescendingMapと同等です。

      定義:
      インタフェースSequencedMap<K,V>内のreversed
      定義:
      インタフェースSortedMap<K,V>内のreversed
      実装要件:
      このインタフェースの実装は、descendingMapメソッドをコールした結果を返します。
      戻り値:
      このマップの逆順ビュー(NavigableMapとして)
      導入されたバージョン:
      21