Método HashMap put() en Java

El método java.util.HashMap.put() de HashMap se utiliza para insertar una asignación en un mapa. Esto significa que podemos insertar una clave específica y el valor al que se asigna en un mapa en particular. Si se pasa una clave existente, el valor anterior se reemplaza por el nuevo valor. Si se pasa un nuevo par, entonces el par se inserta como un todo.

Sintaxis: 
 

Hash_Map.put(key, value)

Parámetros: El método toma dos parámetros, ambos son del tipo Objeto del HashMap. 
 

• clave: Esto se refiere al elemento clave que debe insertarse en el Mapa para el mapeo.
• valor: Esto se refiere al valor al que se asignaría la clave anterior.

Valor devuelto: si se pasa una clave existente, se devuelve el valor anterior. Si se pasa un par nuevo, se devuelve NULL.
Los siguientes programas se utilizan para ilustrar el funcionamiento del método java.util.HashMap.put(): 
Programa 1: al pasar una clave existente. 
 

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

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

Programa 2: Al pasar una nueva clave. 
 

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

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

Nota: La misma operación se puede realizar con cualquier tipo de Mapping con variación y combinación de diferentes tipos de datos.