Java HashMap putIfAbsent(key, value)方法及示例

HashMap 类 的 putIfAbsent(K key, V value) 方法用于将指定的键与指定的值进行映射，只有在该HashMap实例中不存在这样的键（或被映射为空）的情况下才会使用。

语法

public V putIfAbsent(K key, V value)

参数： 该方法接受两个参数。

• key： 提供的值必须与之映射的键。
• value： 如果没有的话，这是与所提供的键相关的值。

返回值 。

该方法返回 null （如果之前没有与所提供的键的映射，或者它被映射到一个空值）或与所提供的键相关的 当前值 。

异常情况

这个方法可以抛出以下异常。

• NullPointerException： 如果指定的键或值是空的，而这个地图不支持空值。
• IllegalArgumentException： 如果指定的键或值阻止它被存储在地图中。
• UnsupportedOperationException – 如果这个地图不支持put操作（可选）。
• ClassCastException – 如果键或值的类型对这个地图来说是不合适的（可选）。

程序1 :

// Java program to demonstrate
// putIfAbsent(Key, value) method.
 
import java.util.HashMap;
 
public class TestClass {
 
    // Main method
    public static void main(String[] args)
    {
 
        // create a HashMap and add some values
        HashMap<String, Integer> map = new HashMap<>();
        map.put("a", 10000);
        map.put("b", 55000);
        map.put("c", 44300);
        map.put("e", 53200);
 
        // print original map
        System.out.println("HashMap:\n " + map.toString());
 
        // put a new value which is not mapped
        // before in map
        map.putIfAbsent("d", 77633);
 
        System.out.println("New HashMap:\n " + map);
 
        // try to put a new value with existing key
        // before in map
        map.putIfAbsent("d", 55555);
 
        // print newly mapped map
        System.out.println("Unchanged HashMap:\n " + map);
    }
}

输出

HashMap:
 {a=10000, b=55000, c=44300, e=53200}
New HashMap:
 {a=10000, b=55000, c=44300, d=77633, e=53200}
Unchanged HashMap:
 {a=10000, b=55000, c=44300, d=77633, e=53200}

程序2

// Java program to demonstrate
// putIfAbsent(Key, value) method.
 
import java.util.*;
 
public class GFG {
 
    // Main method
    public static void main(String[] args)
    {
 
        // create a HashMap and add some values
        HashMap<String, Integer> map = new HashMap<>();
        map.put("a", 10000);
        map.put("b", 55000);
        map.put("c", 44300);
        map.put("e", null);
 
        // print original map
        System.out.println("HashMap:\n " + map.toString());
 
        // put a new value which is not mapped
        // before in map and store the returned
        // value in r1
        Integer r1 = map.putIfAbsent("d", 77633);
 
        // put a new value for key 'e' which is mapped
        // with a null value, and store the returned
        // value in r2
        Integer r2 = map.putIfAbsent("e", 77633);
 
        // print the value of r1
        System.out.println("Value of r1:\n " + r1);
 
        // print the value of r2
        System.out.println("Value of r2:\n " + r2);
 
        // print newly mapped map
        System.out.println("New HashMap:\n " + map);
    }
}

输出

HashMap:
 {a=10000, b=55000, c=44300, e=null}
Value of r1:
 null
Value of r2:
 null
New HashMap:
 {a=10000, b=55000, c=44300, d=77633, e=77633}

参考资料: https://docs.oracle.com/javase/8/docs/api/java/util/HashMap.html#putIfAbsent-K-V-