Home » Java programming language

Java TreeMap higherEntry() Method with Example

TreeMap Class higherEntry() method: Here, we are going to learn about the higherEntry() method of TreeMap Class with its syntax and example.
Submitted by Preeti Jain, on February 29, 2020

TreeMap Class higherEntry() method

• higherEntry() method is available in java.util package.
• higherEntry() method is used to return those key-value pairs mapped with the lowest key value element greater than the given key element (key_ele) otherwise it returns null.
• higherEntry() method is a non-static method, it is accessible with the class object only and if we try to access the method with the class name then we will get an error.
• higherEntry() method may throw an exception at the time of returning higher entry from this map.
  • ClassCastException: This exception may throw when the given parameter is incompatible to compare with.
  • NullPointerException: This exception may throw when the given element is null exists.

Syntax:

    public Map.Entry higherEntry(Key key_ele);

Parameter(s):

• Key key_ele – represents the key element to compare with.

Return value:

The return type of the method is Map.Entry, it returns key-value pairs associated with the lowest key value element exists larger than the given key element (key_ele) when exists otherwise it returns null.

Example:

// Java program to demonstrate the example 
// of Map.Entry higherEntry (Key key_ele) 
// method of TreeMap 

import java.util.*;

public class HigherEntryOfTreeMap {
    public static void main(String[] args) {
        // Instantiates TreeMap
        TreeMap < Integer, String > tm = new TreeMap < Integer, String > ();

        // By using put() method is
        // to put the key-value pairs in
        // treemap tm
        tm.put(1, "C");
        tm.put(4, "C++");
        tm.put(3, "Java");
        tm.put(2, "Php");

        // Display TreeMap tm
        System.out.println("tm: " + tm);

        // By using higherEntry(3) method is
        // return the key-value pair linked with 
        // the lowest key element higher than the 
        // given key element i.e. 4 C++
        // Display Returned Key-Value Element
        System.out.println("tm.higherEntry(3): " + tm.higherEntry(3));
    }
}

Output

tm: {1=C, 2=Php, 3=Java, 4=C++}
tm.higherEntry(3): 4=C++