java 集合类中的 map.put()方法介绍

java.util.Map接口是Java集合框架中的一个重要接口，用于表示键值对的映射关系。其中，put()方法是Map接口定义的一个方法，用于向Map中添加键值对。

put()方法的函数签名如下：

V put(K key, V value)

该方法接受两个参数：key和value。key表示要添加的键，value表示要添加的值。该方法将指定的键值对添加到Map中，并返回之前与给定键关联的值（如果存在），如果之前没有与给定键关联的值，则返回null。

当调用put()方法时，会根据key和value进行以下操作：

1. 如果key已经存在于Map中，则用新的value替换原有的值，并返回原来的值。
2. 如果key不存在于Map中，则将key和value添加到Map中，并返回null。

示例代码如下：

Map<String, Integer> map = new HashMap<>();
map.put("apple", 1); // 添加键值对，返回null
map.put("orange", 2); // 添加键值对，返回null

Integer oldValue = map.put("apple", 3); // 替换键"apple"的值，返回1
System.out.println(oldValue); // 输出1

Integer value = map.get("apple"); // 获取键"apple"对应的值，输出3
System.out.println(value);

需要注意的是，如果使用相同的键多次调用put()方法，后续的值会覆盖之前的值。另外，put()方法返回的是之前与给定键关联的值，因此可以利用该返回值来实现某些逻辑，比如判断是否替换成功或获取之前的值。

总结：put()方法用于向Map中添加键值对，如果键已存在，则替换原有的值并返回之前的值；如果键不存在，则添加新的键值对并返回null。