| 1 |
|
/* |
| 2 |
< |
* %W% %E% |
| 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 %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 |
| 100 |
< |
* @see Vector |
| 108 |
> |
* @see Set |
| 109 |
> |
* @see List |
| 110 |
> |
* @see Map |
| 111 |
> |
* @see SortedSet |
| 112 |
> |
* @see SortedMap |
| 113 |
> |
* @see HashSet |
| 114 |
> |
* @see TreeSet |
| 115 |
> |
* @see ArrayList |
| 116 |
> |
* @see LinkedList |
| 117 |
> |
* @see Vector |
| 118 |
|
* @see Collections |
| 119 |
< |
* @see Arrays |
| 120 |
< |
* @see AbstractCollection |
| 119 |
> |
* @see Arrays |
| 120 |
> |
* @see AbstractCollection |
| 121 |
|
* @since 1.2 |
| 122 |
|
*/ |
| 123 |
|
|
| 277 |
|
* @param o element to be removed from this collection, if present |
| 278 |
|
* @return <tt>true</tt> if an element was removed as a result of this call |
| 279 |
|
* @throws ClassCastException if the type of the specified element |
| 280 |
< |
* is incompatible with this collection (optional) |
| 280 |
> |
* is incompatible with this collection (optional) |
| 281 |
|
* @throws NullPointerException if the specified element is null and this |
| 282 |
|
* collection does not permit null elements (optional) |
| 283 |
|
* @throws UnsupportedOperationException if the <tt>remove</tt> operation |
| 294 |
|
* |
| 295 |
|
* @param c collection to be checked for containment in this collection |
| 296 |
|
* @return <tt>true</tt> if this collection contains all of the elements |
| 297 |
< |
* in the specified collection |
| 297 |
> |
* in the specified collection |
| 298 |
|
* @throws ClassCastException if the types of one or more elements |
| 299 |
|
* in the specified collection are incompatible with this |
| 300 |
|
* collection (optional) |
