java命名空间java.util接口set<e>的类成员方法:
add定义及介绍
本文导语:
add
boolean add(e e)
如果 set 中尚未存在指定的元素,则添加此元素(可选操作)。更确切地讲,如果此 set 没有包含满足 (e==null ? e2==null : e.equals(e2)) 的元素 e2,则向该 set 中添加指定的元素 e。如果此 set 已经包含该元素,则...
boolean add(e e)
- 如果 set 中尚未存在指定的元素,则添加此元素(可选操作)。更确切地讲,如果此 set 没有包含满足 (e==null ? e2==null : e.equals(e2)) 的元素 e2,则向该 set 中添加指定的元素 e。如果此 set 已经包含该元素,则该调用不改变此 set 并返回 false。结合构造方法上的限制,这就可以确保 set 永远不包含重复的元素。
上述规定并未暗示 set 必须接受所有元素;set 可以拒绝添加任意特定的元素,包括 null,并抛出异常,这与 collection.add
规范中所描述的一样。每个 set 实现应该明确地记录对其可能包含元素的所有限制。
- 指定者:
- 接口
collection
中的 add
- 参数:
e
- 要添加到 set 中的元素
- 返回:
- 如果 set 尚未包含指定的元素,则返回 true
- 抛出:
unsupportedoperationexception
- 如果此 set 不支持 add 操作
classcastexception
- 如果指定元素的类不允许它添加到此 set
nullpointerexception
- 如果指定的元素为 null 并且此 set 不允许 null 元素
illegalargumentexception
- 如果指定元素的某些属性不允许它添加到此 set