java.util.TreeMap.headMap() 方法

描述

headMap(K toKey,boolean inclusive) 方法用于返回此映射部分的视图,其键小于(或等于,如果 inclusive 为真)toKey。


声明

以下是 java.util.TreeMap.headMap() 方法的声明。

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

参数

  • toKey − 这是返回映射中键的高端。

  • inclusive − 如果要在返回的视图中包含高端端点,则为 true。


返回值

该方法调用返回此映射部分的视图,其键小于(或等于,如果 inclusive 为真)toKey。


异常

  • ClassCastException − 如果 toKey 与此映射的比较器不兼容,则会引发此异常。

  • NullPointerException − 如果 toKey 为 null 并且此映射使用自然排序,或者其比较器不允许 null 键,则会引发此异常。

  • IllegalArgumentException − 如果此映射本身具有受限范围,并且 toKey 位于范围范围之外,则会引发此异常。


示例

下面的例子展示了 java.util.TreeMap.headMap() 方法的使用。

package com.tutorialspoint;

import java.util.*;

public class TreeMapDemo {
   public static void main(String[] args) {

      // creating maps 
      TreeMap<Integer, String> treemap = new TreeMap<Integer, String>();
      NavigableMap<Integer, String> treemapheadincl = new TreeMap<Integer, String>();

      // populating tree map
      treemap.put(2, "two");
      treemap.put(1, "one");
      treemap.put(3, "three");
      treemap.put(6, "six");
      treemap.put(5, "five");

      // getting head map inclusive 3
      treemapheadincl = treemap.headMap(3,true);

      System.out.println("Checking values of the map");
      System.out.println("Value is: "+ treemapheadincl);
   }    
}

让我们编译并运行上面的程序,这将产生以下结果.

Checking values of the map
Value is: {1=one, 2=two, 3=three}