JAVA笔记——Map集合常用API

一.常用API

V put ( K key , V value )                 加元素
V remove (0bject key )                    根据键删除鍵值对元素
void clear ()                             移除所有的键值对元素
boolean containsKey (0bject key )         判断集合是否包含指定的键
boolean containsValue (0bject value )     判断集合是否包含指定的值
boolean isEmpty )                         判断集合是否为空
int size ()                               集合的长度，也就是集合中键值对的个数

1.V put(K key,V value)

将指定的值与此映射中的指定键关联（可选操作）。如果此映射以前包含一个该键的映射关系，则用指定值替换旧值（当且仅当 m.containsKey(k) 返回 true 时，才能说映射 m 包含键 k 的映射关系）。

参数：

key - 与指定值关联的键

value - 与指定键关联的值

返回：

以前与 key 关联的值，如果没有针对 key 的映射关系，则返回 null。（如果该实现支持 null 值，则返回 null 也可能表示此映射以前将 null 与 key 关联）。

抛出：

UnsupportedOperationException - 如果此映射不支持 put 操作

ClassCastException - 如果指定键或值的类不允许将其存储在此映射中

NullPointerException - 如果指定键或值为 null，并且此映射不允许 null 键或值

IllegalArgumentException - 如果指定键或值的某些属性不允许将其存储在此映射中

        //1.创建Map集合的对象
        Map<String,String > m = new HashMap<>();
 
        //2.添加元素
        //put方法细节
        //添加/覆盖
        //在添加数据的时候，如果健不存在，那么直接把键值对对象添加到map集合当中
        //在添加数据的时候，如果建是存在的，那么会把原有的键值对队象覆盖，会把被覆盖的置进行覆盖
 
 
 
        m.put("郭靖","黄蓉");
        m.put("张三","李四");
 
        String value = m.put("郭靖","阿三");
        System.out.println(value);//黄蓉

2.V remove(Object key)

如果存在一个键的映射关系，则将其从此映射中移除（可选操作）。更确切地讲，如果此映射包含从满足 (key==null ? k==null :key.equals(k)) 的键 k 到值 v 的映射关系，则移除该映射关系。（该映射最多只能包含一个这样的映射关系。）

返回此映射中以前关联该键的值，如果此映射不包含该键的映射关系，则返回 null。

如果此映射允许 null 值，则返回 null 值并不一定 表示该映射不包含该键的映射关系；也可能该映射将该键显示地映射到 null。

调用返回后，此映射将不再包含指定键的映射关系。

参数：

key - 从映射中移除其映射关系的键

返回：

以前与 key 关联的值；如果没有 key 的映射关系，则返回 null。

抛出：

UnsupportedOperationException - 如果此映射不支持 remove 操作

ClassCastException - 如果该键对于此映射是不合适的类型（可选）

NullPointerException - 如果指定键为 null 并且此映射不允许 null 键（可选）

3.void clear()

从此映射中移除所有映射关系（可选操作）。此调用返回后，该映射将为空。

抛出：

UnsupportedOperationException - 如果此映射不支持 clear 操作

4.containsKey

boolean containsKey(Object key)

如果此映射包含指定键的映射关系，则返回 true。更确切地讲，当且仅当此映射包含针对满足 (key==null ? k==null : key.equals(k)) 的键 k 的映射关系时，返回 true。（最多只能有一个这样的映射关系）。

参数：

key - 测试是否存在于此映射中的键

返回：

如果此映射包含指定键的映射关系，则返回 true

抛出：

ClassCastException - 如果该键对于此映射是不合适的类型（可选）

NullPointerException - 如果指定键为 null 并且此映射不允许 null 键（可选）

5.containsValue

boolean containsValue(Object value)

如果此映射将一个或多个键映射到指定值，则返回 true。更确切地讲，当且仅当此映射至少包含一个对满足 (value==null ? v==null : value.equals(v)) 的值 v 的映射关系时，返回 true。对于大多数 Map 接口的实现而言，此操作需要的时间可能与映射大小呈线性关系。

参数：

value - 测试是否存在于此映射中的值

返回：

如果此映射将一个或多个键映射到指定值，则返回 true

抛出：

ClassCastException - 如果该值对于此映射是不合适的类型（可选）

NullPointerException - 如果指定值为 null 并且此映射不允许 null 值（可选）

6.isEmpty

boolean isEmpty()

如果此映射未包含键-值映射关系，则返回 true。

返回：

如果此映射未包含键-值映射关系，则返回 true

7.size

int size()

返回此映射中的键-值映射关系数。如果该映射包含的元素大于 Integer.MAX_VALUE，则返回 Integer.MAX_VALUE。

返回：

此映射中的键-值映射关系数