java命名空间java.util接口collection<e>的类成员方法:
add定义及介绍
本文导语:
add
boolean add(e e)
确保此 collection 包含指定的元素(可选操作)。如果此 collection 由于调用而发生更改,则返回 true。(如果此 collection 不允许有重复元素,并且已经包含了指定的元素,则返回 false。)
支持此操作的 collection ...
boolean add(e e)
- 确保此 collection 包含指定的元素(可选操作)。如果此 collection 由于调用而发生更改,则返回 true。(如果此 collection 不允许有重复元素,并且已经包含了指定的元素,则返回 false。)
支持此操作的 collection 可以限制哪些元素能添加到此 collection 中来。需要特别指出的是,一些 collection 拒绝添加 null 元素,其他一些 collection 将对可以添加的元素类型强加限制。collection 类应该在其文档中清楚地指定能添加哪些元素方面的所有限制。
如果 collection 由于某些原因(已经包含该元素的原因除外)拒绝添加特定的元素,那么它必须 抛出一个异常(而不是返回 false)。这确保了在此调用返回后,collection 总是包含指定的元素。
- 参数:
e
- 确定此 collection 中是否存在的元素。
- 返回:
- 如果此 collection 由于调用而发生更改,则返回 true
- 抛出:
unsupportedoperationexception
- 如果此 collection 不支持 add 操作
classcastexception
- 如果指定元素的类不允许它添加到此 collection 中
nullpointerexception
- 如果指定的元素为 null,并且此 collection 不允许 null 元素
illegalargumentexception
- 如果元素的某属性不允许它添加到此 collection 中
illegalstateexception
- 如果由于插入限制,元素不能在此时间添加