1 |
|
/* |
2 |
< |
* %W% %E% |
2 |
> |
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
22 |
> |
* or visit www.oracle.com if you need additional information or have any |
23 |
> |
* questions. |
24 |
|
*/ |
25 |
|
|
26 |
|
package java.util; |
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) |
427 |
|
* contract for the <tt>Object.hashCode</tt> method, programmers should |
428 |
|
* take note that any class that overrides the <tt>Object.equals</tt> |
429 |
|
* method must also override the <tt>Object.hashCode</tt> method in order |
430 |
< |
* to satisfy the general contract for the <tt>Object.hashCode</tt>method. |
430 |
> |
* to satisfy the general contract for the <tt>Object.hashCode</tt> method. |
431 |
|
* In particular, <tt>c1.equals(c2)</tt> implies that |
432 |
|
* <tt>c1.hashCode()==c2.hashCode()</tt>. |
433 |
|
* |