java.util 第1部分：类集框架 （3）

表15-1 由Collection 定义的方法

方法 描述

boolean add(Object obj) 将obj加入到调用类集中。如果obj被加入到类集中了，则返回true；如果obj已经是类集中的一个成员或类集不能被复制时，则返回false

boolean addAll(Collection c) 将c中的所有元素都加入到调用类集中，如果操作成功（也就是说元素被加入了），则返回true；否则返回false

void clear( ) 从调用类集中删除所有元素

boolean contains(Object obj) 如果obj是调用类集的一个元素，则返回true，否则，返回false

续表

方法 描述

boolean containsAll(Collection c) 如果调用类集包含了c中的所有元素，则返回true；否则，返回false

boolean equals(Object obj) 如果调用类集与obj相等，则返回true；否则返回false

int hashCode( ) 返回调用类集的散列码

boolean isEmpty( ) 如果调用类集是空的，则返回true；否则返回false

Iterator iterator( ) 返回调用类集的迭代程序

Boolean remove(Object obj) 从调用类集中删除obj的一个实例。如果这个元素被删除了，则返回true；否则返回false

Boolean removeAll(Collection c) 从调用类集中删除c的所有元素。如果类集被改变了（也就是说元素被删除了），则返回true；否则返回false

Boolean retainAll(Collection c) 删除调用类集中除了包含在c中的元素之外的全部元素。如果类集被改变了（也就是说元素被删除了），则返回true，否则返回false

int size( ) 返回调用类集中元素的个数

Object[ ] toArray( ) 返回一个数组，该数组包含了所有存储在调用类集中的元素。数组元素是类集元素的拷贝

Object[ ] toArray(Object array[ ]) 返回一个数组，该数组仅仅包含了那些类型与数组元素类型匹配的类集元素。数组元素是类集元素的拷贝。如果array的大小与匹配元素的个数相等，它们被返回到array。如果array的大小比匹配元素的个数小，将分配并返回一个所需大小的新数组，如果array的大小比匹配元素的个数大，在数组中，在类集元素之后的单元被置为null。如果任一类集元素的类型都不是array 的子类型， 则引发一个ArrayStoreException异常调用add( )方法可以将对象加入类集。注意add( )带一个Object类型的参数。因为Object是所有类的超类，所以任何类型的对象可以被存储在一个类集中。然而原始类型可能不行。例如，一个类集不能直接存储类型int，char，double等的值。当然如果想存储这些对象，也可以使用在第14章中介绍的原始类型包装器之一。可以通过调用addAll( )方法将一个类集的全部内容增加到另一个类集中。

可以通过调用remove( )方法将一个对象删除。为了删除一组对象，可以调用removeAll( )方法。调用retainAll( )方法可以将除了一组指定的元素之外的所有元素删除。为了清空类集，可以调用clear( )方法。通过调用contains( )方法，可以确定一个类集是否包含了一个指定的对象。为了确定一个类集是否包含了另一个类集的全部元素，可以调用containsAll( )方法。当一个类集是空的时候，可以通过调用isEmpty( )方法来予以确认。调用size( )方法可以获得类集中当前元素的个数。toArray( )方法返回一个数组，这个数组包含了存储在调用类集中的元素。这个方法比它初看上去的能力要更重要。经常使用类数组语法来处理类集的内容是有优势的。通过在类集和数组之间提供一条路径，可以充分利用这两者的优点。调用equals( )方法可以比较两个类集是否相等。“相等”的精确含义可以不同于从类集到类集。例如，可以执行equals( )方法以便用于比较存储在类集中的元素的值，换句话说，equals( )方法能比较对元素的引用。一个更加重要的方法是iterator( )，该方法对类集返回一个迭代程序。正如你将看到的那样，当使用一个类集框架时，迭代程序对于成功的编程来说是至关重要的。