headMap(K toKey) 方法用於返回此映射的鍵嚴格小於toKey的部分視圖。

聲明

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

public SortedMap<K,V> headMap(K toKey)

參數

• toKey--這是在返回映射中鍵的高端點(不包括)。

返回值

在方法調用返回此映射的鍵嚴格小於toKey部分視圖。

異常

• ClassCastException-- 拋出此異常如果toKey與此映射的比較兼容(如果該映射冇有比較器，如果toKey冇有實現Comparable)。實現方式可以，但不要求，拋出此異常，如果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>();
      SortedMap<Integer, String> treemaphead = 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
      treemaphead=treemap.headMap(3);
      
      System.out.println("Checking values of the sorted map");
      System.out.println("Value is: "+ treemaphead);
   }    
}

現在編譯和運行上麵的代碼示例，將產生以下結果。

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