TreeMap firstEntry() Method in Java with Examples

Last Updated : 25 Aug, 2020

TreeMap firstEntry() refers to the method used to retrieve the key-value pairs mapped with the lowest key value element that exists in the TreeMap, if there are no key-value pairs within the Map, simply returns null. The method name 'firstEntry()' explains itself that it will return entry having the least key element with its value.

Syntax: public Map.Entry<K,V> firstEntry(), Here K and V refer key-value respectively. Parameters: NA - As it doesnot accept any parameter. Return Value: It returns an entry with the least key (lowest key-value pair) and null if the TreeMap is empty. Exception: NA - As it doesnot throw any exception at entry return.

Example 1:

Java

// Java code to demonstrate  // the working of TreeMap firstKey()  import java.io.*;  import java.util.*;  public class treeMapFirstKey {  public static void main(String[] args)   {     // Declaring the TreeMap of Key - Value Pairs  // Integer - Key , String - Value  TreeMap<Integer, String> treemap = new TreeMap<Integer, String>();     // Adding-up the values in the TreeMap   // Use put() function to append data   treemap.put(2, "Java");   treemap.put(4, "CPP");   treemap.put(5, "PHP");   treemap.put(1, "Python");   treemap.put(3, "C");     // Check for firstEntry()  System.out.println("Lowest Entry is: " + treemap.firstEntry());   }  }

Output

Lowest Entry is: 1=Python

By the above example, it's clear that firstEntry() checks compare each key of TreeMap, and returns having the least key-value pair.

Example 2:

Java

// Java code to demonstrate the working // of TreeMap firstKey() method import java.io.*;  import java.util.*;  public class percentageFirstKey {  public static void main(String[] args)   {     // Declaring the TreeMap of Key - Value Pairs  // Double - Key , String - Value  TreeMap<Double, String> treemapPercentage = new TreeMap<Double, String>();     // Adding-up the values in the TreeMap   // Use put() function to append data   treemapPercentage.put(81.40, "Shashank");   treemapPercentage.put(72.80, "Anand");  treemapPercentage.put(65.50, "Gulshan");  treemapPercentage.put(71.10, "Abhishek");   treemapPercentage.put(70.20, "Ram");     // Check for firstEntry()  System.out.println("Lowest Entry is: " + treemapPercentage.firstEntry());   }  }

Output

Lowest Entry is: 65.5=Gulshan

Some points on TreeMap firstEntry():

TreeMap firstEntry() is available in java.util package.
It does not throw an exception at return entry time.
TreeMap firstEntry() method is a non-static method as it is accessible by the class's object, other than that, will get an error.