java.util.TreeSet.headSet() 方法

描述

headSet(E toElement,boolean inclusive) 方法用于返回该集合中元素小于（或等于，如果 inclusive 为真）toElement 的部分的视图。 返回的集合由该集合支持，因此返回集合中的更改会反映在该集合中，反之亦然。

声明

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

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

参数

• toElement − 这是返回集的高端点。

• inclusive − 如果要在返回的视图中包含高端端点，这是正确的。

返回值

该方法调用返回该集合中元素小于（或等于，如果 inclusive 为真）toElement 的部分的视图。

异常

• ClassCastException − 如果 toElement 与该集合的比较器不兼容，则会抛出此错误。

• NullPointerException − 如果 toElement 为 null 并且此 set 使用自然排序，或者其比较器不允许 null 元素，则会抛出此错误。

• IllegalArgumentException − 如果此 set 本身具有受限范围，并且 toElement 位于范围边界之外，则会引发此错误。

示例

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

package com.tutorialspoint;

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