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

声明

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

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

参数

• toKey-- 这是在返回映射中键的高端点。

• inclusive-- true如果高端点要包含在返回的视图。

返回值

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

异常

• ClassCastException--抛出此异常如果toKey与此映射的比较兼容。

• NullPointerException--抛出此异常如果toKey为null，并且此映射使用自然排序，或者其比较器不允许使用null键。

• IllegalArgumentException--这个异常被抛出，如果此映射本身有范围限制，并且toKey位于范围的边界之外。

例子

下面的示例演示java.util.TreeMap.headMap()方法的用法。

package com.yiibai;

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}