headSet(E toElement,boolean inclusive) 方法用於返回此set，其元素小於的部分視圖(或等於，如果inclusive為true)toElement。返回的set受此set支持，因此改變在返回集反映在此set中，反之亦然。

聲明

以下是java.util.TreeSet.headSet()方法的聲明。

public NavigableSet<E> headSet(E toElement,boolean inclusive)

參數

• toElement--這是返回集合的高端點。

• inclusive--這為true，如果高端點要包含在返回的視圖。

返回值

該方法調用返回此set，其元素小於的部分視圖 toElement(或等於，如果inclusive為true)。

異常

• ClassCastException-- 這被拋出如果toElement與此set的比較器不兼容。

• NullPointerException--這被拋出如果toElement為null，並且此set使用自然順序，或者其比較器不允許使用null元素。

• IllegalArgumentException--這被拋出，如果此set本身有範圍限製，並且toElement位於範圍的邊界之外。

例子

下麵的例子展示java.util.TreeSet.headSet()方法的使用。

package com.yiibai;

import java.util.Iterator;
import java.util.TreeSet;

public class TreeSetDemo {
   public static void main(String[] args) {
     // creating TreeSet 
     TreeSet <Integer>tree = new TreeSet<Integer>();
     TreeSet <Integer>treeheadsetincl = new TreeSet<Integer>();
     
     // adding in the tree
     tree.add(12);
     tree.add(13);
     tree.add(14);
     tree.add(15);
     tree.add(16);
     tree.add(17);
     
     // getting values for 15 inclusive true
     treeheadsetincl = (TreeSet)tree.headSet(15, true);  
 
     // creating iterator
     Iterator iterator;
     iterator = treeheadsetincl.iterator();
     
     //Displaying the tree set data
     System.out.println("Tree set data for '15' inclusive TRUE: ");     
     while (iterator.hasNext()){
        System.out.println(iterator.next() + " ");
     }
     
     // getting values for 15 inclusive false
     treeheadsetincl = (TreeSet)tree.headSet(15, false);  
 
     // creating iterator     
     iterator = treeheadsetincl.iterator();
     
     //Displaying the tree set data
     System.out.println("Tree set data for '15' inclusive FALSE: ");     
     while (iterator.hasNext()){
        System.out.println(iterator.next() + " ");
     }
   }    
}

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

Tree set data for '15' inclusive TRUE: 
12 
13 
14 
15 
Tree set data for '15' inclusive FALSE: 
12 
13 
14