一.常用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。
返回:
此映射中的键-值映射关系数