1 |
|
/* |
2 |
< |
* @(#)Collection.java 1.52 05/08/27 |
2 |
> |
* Copyright 1997-2006 Sun Microsystems, Inc. All Rights Reserved. |
3 |
> |
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 |
|
* |
5 |
< |
* Copyright 2005 Sun Microsystems, Inc. All rights reserved. |
6 |
< |
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. |
5 |
> |
* This code is free software; you can redistribute it and/or modify it |
6 |
> |
* under the terms of the GNU General Public License version 2 only, as |
7 |
> |
* published by the Free Software Foundation. Sun designates this |
8 |
> |
* particular file as subject to the "Classpath" exception as provided |
9 |
> |
* by Sun in the LICENSE file that accompanied this code. |
10 |
> |
* |
11 |
> |
* This code is distributed in the hope that it will be useful, but WITHOUT |
12 |
> |
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
13 |
> |
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
14 |
> |
* version 2 for more details (a copy is included in the LICENSE file that |
15 |
> |
* accompanied this code). |
16 |
> |
* |
17 |
> |
* You should have received a copy of the GNU General Public License version |
18 |
> |
* 2 along with this work; if not, write to the Free Software Foundation, |
19 |
> |
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
20 |
> |
* |
21 |
> |
* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, |
22 |
> |
* CA 95054 USA or visit www.sun.com if you need additional information or |
23 |
> |
* have any questions. |
24 |
|
*/ |
25 |
|
|
26 |
|
package java.util; |
76 |
|
* |
77 |
|
* <p>It is up to each collection to determine its own synchronization |
78 |
|
* policy. In the absence of a stronger guarantee by the |
79 |
< |
* implementation, undefined bahavior may result from the invocation |
79 |
> |
* implementation, undefined behavior may result from the invocation |
80 |
|
* of any method on a collection that is being mutated by another |
81 |
|
* thread; this includes direct invocations, passing the collection to |
82 |
|
* a method that might perform invocations, and using an existing |
100 |
|
* implementor deems it appropriate. |
101 |
|
* |
102 |
|
* <p>This interface is a member of the |
103 |
< |
* <a href="{@docRoot}/../guide/collections/index.html"> |
103 |
> |
* <a href="{@docRoot}/../technotes/guides/collections/index.html"> |
104 |
|
* Java Collections Framework</a>. |
105 |
|
* |
106 |
|
* @author Josh Bloch |
107 |
|
* @author Neal Gafter |
108 |
< |
* @version 1.52, 08/27/05 |
109 |
< |
* @see Set |
110 |
< |
* @see List |
111 |
< |
* @see Map |
112 |
< |
* @see SortedSet |
113 |
< |
* @see SortedMap |
114 |
< |
* @see HashSet |
115 |
< |
* @see TreeSet |
116 |
< |
* @see ArrayList |
117 |
< |
* @see LinkedList |
118 |
< |
* @see Vector |
108 |
> |
* @version %I%, %G% |
109 |
> |
* @see Set |
110 |
> |
* @see List |
111 |
> |
* @see Map |
112 |
> |
* @see SortedSet |
113 |
> |
* @see SortedMap |
114 |
> |
* @see HashSet |
115 |
> |
* @see TreeSet |
116 |
> |
* @see ArrayList |
117 |
> |
* @see LinkedList |
118 |
> |
* @see Vector |
119 |
|
* @see Collections |
120 |
< |
* @see Arrays |
121 |
< |
* @see AbstractCollection |
120 |
> |
* @see Arrays |
121 |
> |
* @see AbstractCollection |
122 |
|
* @since 1.2 |
123 |
|
*/ |
124 |
|
|
278 |
|
* @param o element to be removed from this collection, if present |
279 |
|
* @return <tt>true</tt> if an element was removed as a result of this call |
280 |
|
* @throws ClassCastException if the type of the specified element |
281 |
< |
* is incompatible with this collection (optional) |
281 |
> |
* is incompatible with this collection (optional) |
282 |
|
* @throws NullPointerException if the specified element is null and this |
283 |
|
* collection does not permit null elements (optional) |
284 |
|
* @throws UnsupportedOperationException if the <tt>remove</tt> operation |
295 |
|
* |
296 |
|
* @param c collection to be checked for containment in this collection |
297 |
|
* @return <tt>true</tt> if this collection contains all of the elements |
298 |
< |
* in the specified collection |
298 |
> |
* in the specified collection |
299 |
|
* @throws ClassCastException if the types of one or more elements |
300 |
|
* in the specified collection are incompatible with this |
301 |
|
* collection (optional) |