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}