模块  java.base
软件包  java.util.concurrent

Interface ConcurrentNavigableMap<K,​V>

    • 方法详细信息

      • subMap

        ConcurrentNavigableMap<K,​V> subMap​(K fromKey,
                                                 boolean fromInclusive,
                                                 K toKey,
                                                 boolean toInclusive)
        从界面复制的说明: NavigableMap
        返回此映射部分的视图,其键的范围为fromKeytoKey 如果fromKeytoKey相等,则返回的映射为空,除非fromInclusivetoInclusive都为真。 返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入一个键,或者构造一个其端点位于其范围之外的子图,从而抛出IllegalArgumentException

        Specified by:
        subMap ,界面 NavigableMap<K,​V>
        参数
        fromKey - 返回映射中键的低端点
        fromInclusive - true如果 true低端点包含在返回的视图中
        toKey - 返回映射中键的高端点
        toInclusive - true如果 true高端点包含在返回的视图中
        结果
        此地图部分的视图,其键范围为 fromKeytoKey
        异常
        ClassCastException - 如果fromKeytoKey无法使用此映射的比较器相互比较(或者,如果映射没有比较器,则使用自然顺序)。 如果无法将fromKeytoKey与当前映射中的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromKeytoKey为null且此映射不允许null键
        IllegalArgumentException - 如果fromKey大于toKey ; 或者如果此地图本身具有受限范围,则fromKeytoKey位于范围的范围之外
      • headMap

        ConcurrentNavigableMap<K,​V> headMap​(K toKey,
                                                  boolean inclusive)
        从界面复制的说明: NavigableMap
        返回此映射的部分视图,其键小于(或等于,如果inclusive为真) toKey 返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入密钥时抛出IllegalArgumentException

        Specified by:
        headMap ,界面 NavigableMap<K,​V>
        参数
        toKey - 返回映射中键的高端点
        inclusive - true如果 true高端点包含在返回的视图中
        结果
        键映射部分的视图,其键小于(或等于,如果 inclusive为真) toKey
        异常
        ClassCastException - 如果toKey与此映射的比较器不兼容(或者,如果映射没有比较器,则toKey未实现Comparable )。 如果toKey无法与地图中当前的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 toKey为null且此映射不允许空键
        IllegalArgumentException - 如果此地图本身具有受限范围,并且 toKey位于范围的范围之外
      • tailMap

        ConcurrentNavigableMap<K,​V> tailMap​(K fromKey,
                                                  boolean inclusive)
        从界面复制的说明: NavigableMap
        返回此映射部分的视图,其键大于(或等于,如果inclusive为真) fromKey 返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入密钥时抛出IllegalArgumentException

        Specified by:
        tailMap ,界面 NavigableMap<K,​V>
        参数
        fromKey - 返回映射中键的低端点
        inclusive - true如果 true低端点包含在返回的视图中
        结果
        此映射的部分视图,其键大于(或等于,如果 inclusive为真) fromKey
        异常
        ClassCastException - 如果fromKey与此映射的比较器不兼容(或者,如果映射没有比较器,则fromKey不实现Comparable )。 如果fromKey无法与地图中当前的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromKey为null且此映射不允许空键
        IllegalArgumentException - 如果此地图本身具有受限范围,并且 fromKey位于范围的范围之外
      • subMap

        ConcurrentNavigableMap<K,​V> subMap​(K fromKey,
                                                 K toKey)
        从界面复制的说明: NavigableMap
        返回此映射部分的视图,其键的范围从fromKey (包括toKey )到toKey (独占)。 (如果fromKeytoKey相等,则返回的地图为空。)返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入密钥时抛出IllegalArgumentException

        相当于subMap(fromKey, true, toKey, false)

        Specified by:
        subMap ,界面 NavigableMap<K,​V>
        Specified by:
        subMap in interface SortedMap<K,​V>
        参数
        fromKey - 返回映射中键的低端点(包括)
        toKey - 返回映射中键的高端点(独占)
        结果
        此地图部分的视图,其范围从 fromKey (含)到 toKey ,独家
        异常
        ClassCastException - 如果fromKeytoKey无法使用此映射的比较器相互比较(或者,如果映射没有比较器,则使用自然顺序)。 如果无法将fromKeytoKey与当前映射中的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromKeytoKey为null且此映射不允许null键
        IllegalArgumentException - 如果fromKey大于toKey ; 或者如果此地图本身具有受限范围,则fromKeytoKey位于范围的范围之外
      • headMap

        ConcurrentNavigableMap<K,​V> headMap​(K toKey)
        从界面复制的说明: NavigableMap
        返回此映射的部分视图,其键严格小于toKey 返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入一个键时抛出IllegalArgumentException

        相当于headMap(toKey, false)

        Specified by:
        headMap在界面 NavigableMap<K,​V>
        Specified by:
        headMap在界面 SortedMap<K,​V>
        参数
        toKey - 返回映射中键的高端点(不包括)
        结果
        此地图部分的视图,其键严格小于 toKey
        异常
        ClassCastException - 如果toKey与此映射的比较器不兼容(或者,如果映射没有比较器,则toKey未实现Comparable )。 如果toKey无法与地图中当前的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 toKey为null且此映射不允许空键
        IllegalArgumentException - 如果此地图本身具有受限范围,并且 toKey位于范围的范围之外
      • tailMap

        ConcurrentNavigableMap<K,​V> tailMap​(K fromKey)
        从界面复制的说明: NavigableMap
        返回此映射的部分视图,其键大于或等于fromKey 返回的地图由此地图支持,因此返回的地图中的更改将反映在此地图中,反之亦然。 返回的地图支持此地图支持的所有可选地图操作。

        返回的地图将尝试在其范围之外插入密钥时抛出IllegalArgumentException

        相当于tailMap(fromKey, true)

        Specified by:
        tailMap在界面 NavigableMap<K,​V>
        Specified by:
        tailMap在接口 SortedMap<K,​V>
        参数
        fromKey - 返回映射中键的低端点(包括)
        结果
        此映射的部分视图,其键大于或等于 fromKey
        异常
        ClassCastException - 如果fromKey与此映射的比较器不兼容(或者,如果映射没有比较器,则fromKey未实现Comparable )。 如果fromKey无法与地图中当前的键进行比较,则实现可能(但不是必须)抛出此异常。
        NullPointerException - 如果 fromKey为null且此映射不允许空键
        IllegalArgumentException - 如果此地图本身具有受限范围,并且 fromKey位于范围的范围之外
      • descendingMap

        ConcurrentNavigableMap<K,​V> descendingMap()
        返回此映射中包含的映射的逆序视图。 降序地图由此地图支持,因此对地图的更改将反映在降序地图中,反之亦然。

        返回的地图的排序等同于Collections.reverseOrder (comparator()) 表达m.descendingMap().descendingMap()返回一个视图的m实质上等同于m

        Specified by:
        descendingMap ,界面 NavigableMap<K,​V>
        结果
        此地图的逆序视图
      • navigableKeySet

        NavigableSet<K> navigableKeySet()
        返回此映射中包含的键的NavigableSet视图。 set的迭代器按升序返回键。 该集由地图支持,因此对地图的更改将反映在集中,反之亦然。 该组支持元件移除,即从映射中相应的映射,经由Iterator.removeSet.removeremoveAllretainAll ,和clear操作。 它不支持addaddAll操作。

        视图的迭代器和分裂器是weakly consistent

        Specified by:
        navigableKeySet在界面 NavigableMap<K,​V>
        结果
        此地图中键的可导航设置视图
      • keySet

        NavigableSet<K> keySet()
        返回此映射中包含的键的NavigableSet视图。 set的迭代器按升序返回键。 该集由地图支持,因此对地图的更改将反映在集中,反之亦然。 该组支持元件移除,即从映射中相应的映射,经由Iterator.removeSet.removeremoveAllretainAll ,和clear操作。 它不支持addaddAll操作。

        视图的迭代器和分裂器是weakly consistent

        该方法等同于方法navigableKeySet

        Specified by:
        keySet在界面 Map<K,​V>
        Specified by:
        keySet ,界面 SortedMap<K,​V>
        结果
        此地图中键的可导航设置视图
      • descendingKeySet

        NavigableSet<K> descendingKeySet()
        返回此映射中包含的键的反向顺序NavigableSet视图。 set的迭代器按降序返回键。 该集由地图支持,因此对地图的更改将反映在集中,反之亦然。 该组支持元件移除,即从映射中相应的映射,经由Iterator.removeSet.removeremoveAllretainAll ,和clear操作。 它不支持addaddAll操作。

        视图的迭代器和分裂器是weakly consistent

        Specified by:
        descendingKeySet ,界面 NavigableMap<K,​V>
        结果
        此映射中键的反向可导航设置视图