SortedMap headMap() método en Java

El método headMap() de la interfaz SortedMap en Java se usa para devolver una vista de la parte de este mapa cuyas claves son estrictamente menores que toKey.

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

Nota : el mapa devuelto por este método generará una IllegalArgumentException si se intenta insertar una clave fuera de su rango.

Sintaxis :

SortedMap<K, V> headMap(K toKey)

Donde, K es el tipo de clave mantenida por este Conjunto y V es el tipo de valores asociados a la Clave.

Parámetros : esta función acepta un solo parámetro toKey que representa el punto final superior (exclusivo) de las claves en el mapa devuelto.

Valor devuelto : Devuelve una vista de la porción de este mapa cuyas claves son estrictamente menores que toKey.

excepción :

• ClassCastException : si el parámetro toKey no es compatible con el comparador de este mapa (o, si el mapa no tiene comparador, si toKey no implementa Comparable).
• NullPointerException : si el parámetro toKey es nulo y este mapa no permite claves nulas.
• IllegalArgumentException : si este mapa en sí tiene un rango restringido y toKey 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.*;
  
public class Main {
    public static void main(String[] args)
    {
        // Create a TreeSet and inserting elements
        SortedMap<Integer, String> mp = new TreeMap<>();
  
        // Adding Element to SortedSet
        mp.put(1, "One");
        mp.put(2, "Two");
        mp.put(3, "Three");
        mp.put(4, "Four");
        mp.put(5, "Five");
  
        // Returning the map with key less than 3
        System.out.print("Last Key in the map is : "
                         + mp.headMap(3));
    }
}

Last Key in the map is : {1=One, 2=Two}

Programa 2 :

// A Java program to demonstrate
// working of SortedSet
import java.util.*;
  
public class Main {
    public static void main(String[] args)
    {
        // Create a TreeSet and inserting elements
        SortedMap<String, String> mp = new TreeMap<>();
  
        // Adding Element to SortedSet
        mp.put("One", "Geeks");
        mp.put("Two", "For");
        mp.put("Three", "Geeks");
        mp.put("Four", "Code");
        mp.put("Five", "It");
  
        // Returning map with key less than H
        System.out.print("Last Key in the map is : "
                         + mp.headMap("H"));
    }
}

Last Key in the map is : {Five=It, Four=Code}

Referencia : https://docs.oracle.com/javase/10/docs/api/java/util/SortedMap.html#headMap(K)