NavigableMap put() Method in Java

The put() method of NavigableMap Interface is used to insert a mapping into a map. This means we can insert a specific key and the value it is mapping to into a particular map. If an existing key is passed then the previous value gets replaced by the new value. If a new pair is passed, then the pair gets inserted as a whole.

Syntax:

NavigableMap.put(key, value)

Parameters: The method takes two parameters, both are of the Object type of the Map taken.



  • key: This refers to the key element that needs to be inserted into the Map for mapping.
  • value: This refers to the value that the above key would map into.

Return Value: If an existing key is passed then the previous value gets returned. If a new pair is passed, then NULL is returned.

Below programs are used to illustrate the working of put() method:
Program 1: When passing an existing key.

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java code to illustrate the put() method
import java.util.*;
  
public class NavigableMapDemo {
    public static void main(String[] args)
    {
  
        // Creating an empty NavigableMap
        NavigableMap<Integer, String> nav_map = new TreeMap<Integer, String>();
  
        // Mapping string values to int keys
        nav_map.put(10, "Geeks");
        nav_map.put(15, "4");
        nav_map.put(20, "Geeks");
        nav_map.put(25, "Welcomes");
        nav_map.put(30, "You");
  
        // Displaying the Map
        System.out.println("Initial Mappings are: " + nav_map);
  
        // Inserting existing key along with new value
        String returned_value = (String)nav_map.put(20, "All");
  
        // Verifying the returned value
        System.out.println("Returned value is: " + returned_value);
  
        // Displayin the new map
        System.out.println("New map is: " + nav_map);
    }
}

chevron_right


Output:

Initial Mappings are: {10=Geeks, 15=4, 20=Geeks, 25=Welcomes, 30=You}
Returned value is: Geeks
New map is: {10=Geeks, 15=4, 20=All, 25=Welcomes, 30=You}

Program 2: When passing a new key.

filter_none

edit
close

play_arrow

link
brightness_4
code

// Java code to illustrate the put() method
import java.util.*;
  
public class NavigableMapDemo {
    public static void main(String[] args)
    {
  
        // Creating an empty TreeMap
        NavigableMap<Integer, String> nav_map = new TreeMap<Integer, String>();
  
        // Mapping string values to int keys
        nav_map.put(10, "Geeks");
        nav_map.put(15, "4");
        nav_map.put(20, "Geeks");
        nav_map.put(25, "Welcomes");
        nav_map.put(30, "You");
  
        // Displaying the TreeMap
        System.out.println("Initial Mappings are: " + nav_map);
  
        // Inserting existing key along with new value
        String returned_value = (String)nav_map.put(50, "All");
  
        // Verifying the returned value
        System.out.println("Returned value is: " + returned_value);
  
        // Displayin the new map
        System.out.println("New map is: " + nav_map);
    }
}

chevron_right


Output:

Initial Mappings are: {10=Geeks, 15=4, 20=Geeks, 25=Welcomes, 30=You}
Returned value is: null
New map is: {10=Geeks, 15=4, 20=Geeks, 25=Welcomes, 30=You, 50=All}

Note: The same operation can be performed with any type of Mappings with variation and combination of different data types.



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :
Practice Tags :


Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.