Java SortedMap headMap()用法及代碼示例

Java中SortedMap接口的headMap()方法用於返回此映射的部分(其鍵嚴格小於toKey)的視圖。

此方法返回的Map由該Map支持，因此返回的Map中的更改會反映在該Map中，反之亦然。
此方法返回的Map支持該Map支持的所有可選Map操作。

注意：如果試圖插入超出其範圍的鍵，則此方法返回的映射將拋出IllegalArgumentException。

用法：

SortedMap<K, V> headMap(K toKey)

其中，K是此Set維護的鍵的類型，V是與該鍵關聯的值的類型。

參數：此函數接受單個參數toKey，該參數表示返回映射中鍵的高端端點(不包括)。

返回值：返回此Map部分的視圖，其鍵嚴格小於toKey。

異常：

ClassCastException：如果參數toKey與該Map的比較器不兼容(或者，如果Map沒有比較器，則toKey不實現Comparable)。
NullPointerException ：如果參數toKey為null，並且此映射不允許使用null鍵。
IllegalArgumentException：如果此Map本身具有限製範圍，並且toKey位於範圍的邊界之外

以下示例程序旨在說明上述方法：

程序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}

程序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}

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

相關用法

注：本文由純淨天空篩選整理自barykrg大神的英文原創作品 SortedMap headMap() method in Java。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。