SortedSet headSet() método en Java

El método headSet() de la interfaz SortedSet en Java se usa para devolver una vista de la parte de este conjunto cuyos elementos son estrictamente menores que el parámetro toElement .

• El conjunto devuelto por este método está respaldado por este conjunto, por lo que los cambios en el conjunto devuelto se reflejan en este conjunto y viceversa.
• El conjunto devuelto por este método admite todas las operaciones de conjunto opcionales que admite este conjunto.

Nota : el conjunto devuelto por este método arrojará una IllegalArgumentException si se intenta insertar un elemento fuera de su rango.

Sintaxis :

SortedSet headSet(E toElement)

Donde, E es el tipo de elemento que mantiene este Conjunto.

Parámetros : esta función acepta un solo parámetro toElement que representa el punto final superior (exclusivo) del conjunto devuelto.

Valor devuelto : Devuelve el último o el elemento más alto actualmente en el conjunto.

Excepciones :

• ClassCastException : lanza una ClassCastException si toElement no es compatible con el comparador de este conjunto (o, si el conjunto no tiene comparador, si toElement no implementa Comparable).
• NullPointerException : lanza una NullPointerException si el parámetro toElement es nulo.
• IllegalArgumentException : lanza una IllegalArgumentException, este conjunto en sí tiene un rango restringido y el parámetro toElement se encuentra fuera de los límites del rango.

Los siguientes programas ilustran el método anterior:

Programa 1 :

// A Java program to demonstrate
// working of SortedSet
import java.util.SortedSet;
import java.util.TreeSet;
  
public class Main {
    public static void main(String[] args)
    {
        // Create a TreeSet and inserting elements
        SortedSet<Integer> s = new TreeSet<>();
  
        // Adding Element to SortedSet
        s.add(1);
        s.add(5);
        s.add(2);
        s.add(3);
        s.add(9);
  
        // Returning the set with elements
        // strictly less than the passed value
        System.out.print("Elements strictly less than 7 in set are : "
                         + s.headSet(7));
    }
}

Elements strictly less than 7 in set are : [1, 2, 3, 5]

Programa 2 :

// A Java program to demonstrate
// working of SortedSet
import java.util.SortedSet;
import java.util.TreeSet;
  
public class Main {
    public static void main(String[] args)
    {
        // Create a TreeSet and inserting elements
        SortedSet<String> s = new TreeSet<>();
  
        // Adding Element to SortedSet
        s.add("Geeks");
        s.add("For");
        s.add("Geeks");
        s.add("Code");
        s.add("It");
  
        // Returning the set with elements
        // strictly less than the passed value
        System.out.print("Element strictly less than Z in set is : "
                         + s.headSet("Z"));
    }
}

Element strictly less than Z in set is : [Code, For, Geeks, It]

Referencia : https://docs.oracle.com/javase/10/docs/api/java/util/SortedSet.html#headSet(E)