37 |
|
* <p>Beware that, unlike in most collections, the <tt>size</tt> |
38 |
|
* method is <em>not</em> a constant-time operation. Because of the |
39 |
|
* asynchronous nature of these maps, determining the current number |
40 |
< |
* of elements requires a traversal of the elements. Additionally, |
41 |
< |
* the bulk operations <tt>putAll</tt>, <tt>equals</tt>, and |
42 |
< |
* <tt>clear</tt> are <em>not</em> guaranteed to be performed |
43 |
< |
* atomically. For example, an iterator operating concurrently with a |
44 |
< |
* <tt>putAll</tt> operation might view only some of the added |
45 |
< |
* elements. |
40 |
> |
* of elements requires a traversal of the elements, and so may report |
41 |
> |
* inaccurate results if this collection is modified during traversal. |
42 |
> |
* Additionally, the bulk operations <tt>putAll</tt>, <tt>equals</tt>, |
43 |
> |
* <tt>toArray</tt>, <tt>containsValue</tt>, and <tt>clear</tt> are |
44 |
> |
* <em>not</em> guaranteed to be performed atomically. For example, an |
45 |
> |
* iterator operating concurrently with a <tt>putAll</tt> operation |
46 |
> |
* might view only some of the added elements. |
47 |
|
* |
48 |
|
* <p>This class and its views and iterators implement all of the |
49 |
|
* <em>optional</em> methods of the {@link Map} and {@link Iterator} |
1633 |
|
/** |
1634 |
|
* Returns <tt>true</tt> if this map maps one or more keys to the |
1635 |
|
* specified value. This operation requires time linear in the |
1636 |
< |
* map size. |
1636 |
> |
* map size. Additionally, it is possible for the map to change |
1637 |
> |
* during execution of this method, in which case the returned |
1638 |
> |
* result may be inaccurate. |
1639 |
|
* |
1640 |
|
* @param value value whose presence in this map is to be tested |
1641 |
|
* @return <tt>true</tt> if a mapping to <tt>value</tt> exists; |