< prev index next >

src/java.base/share/classes/java/util/LinkedHashMap.java

Print this page




 123  * the iterator is created, in any way except through the iterator's own
 124  * {@code remove} method, the iterator will throw a {@link
 125  * ConcurrentModificationException}.  Thus, in the face of concurrent
 126  * modification, the iterator fails quickly and cleanly, rather than risking
 127  * arbitrary, non-deterministic behavior at an undetermined time in the future.
 128  *
 129  * <p>Note that the fail-fast behavior of an iterator cannot be guaranteed
 130  * as it is, generally speaking, impossible to make any hard guarantees in the
 131  * presence of unsynchronized concurrent modification.  Fail-fast iterators
 132  * throw {@code ConcurrentModificationException} on a best-effort basis.
 133  * Therefore, it would be wrong to write a program that depended on this
 134  * exception for its correctness:   <i>the fail-fast behavior of iterators
 135  * should be used only to detect bugs.</i>
 136  *
 137  * <p>The spliterators returned by the spliterator method of the collections
 138  * returned by all of this class's collection view methods are
 139  * <em><a href="Spliterator.html#binding">late-binding</a></em>,
 140  * <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}.
 141  *
 142  * <p>This class is a member of the
 143  * <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework">
 144  * Java Collections Framework</a>.
 145  *
 146  * @implNote
 147  * The spliterators returned by the spliterator method of the collections
 148  * returned by all of this class's collection view methods are created from
 149  * the iterators of the corresponding collections.
 150  *
 151  * @param <K> the type of keys maintained by this map
 152  * @param <V> the type of mapped values
 153  *
 154  * @author  Josh Bloch
 155  * @see     Object#hashCode()
 156  * @see     Collection
 157  * @see     Map
 158  * @see     HashMap
 159  * @see     TreeMap
 160  * @see     Hashtable
 161  * @since   1.4
 162  */
 163 public class LinkedHashMap<K,V>




 123  * the iterator is created, in any way except through the iterator's own
 124  * {@code remove} method, the iterator will throw a {@link
 125  * ConcurrentModificationException}.  Thus, in the face of concurrent
 126  * modification, the iterator fails quickly and cleanly, rather than risking
 127  * arbitrary, non-deterministic behavior at an undetermined time in the future.
 128  *
 129  * <p>Note that the fail-fast behavior of an iterator cannot be guaranteed
 130  * as it is, generally speaking, impossible to make any hard guarantees in the
 131  * presence of unsynchronized concurrent modification.  Fail-fast iterators
 132  * throw {@code ConcurrentModificationException} on a best-effort basis.
 133  * Therefore, it would be wrong to write a program that depended on this
 134  * exception for its correctness:   <i>the fail-fast behavior of iterators
 135  * should be used only to detect bugs.</i>
 136  *
 137  * <p>The spliterators returned by the spliterator method of the collections
 138  * returned by all of this class's collection view methods are
 139  * <em><a href="Spliterator.html#binding">late-binding</a></em>,
 140  * <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}.
 141  *
 142  * <p>This class is a member of the
 143  * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
 144  * Java Collections Framework</a>.
 145  *
 146  * @implNote
 147  * The spliterators returned by the spliterator method of the collections
 148  * returned by all of this class's collection view methods are created from
 149  * the iterators of the corresponding collections.
 150  *
 151  * @param <K> the type of keys maintained by this map
 152  * @param <V> the type of mapped values
 153  *
 154  * @author  Josh Bloch
 155  * @see     Object#hashCode()
 156  * @see     Collection
 157  * @see     Map
 158  * @see     HashMap
 159  * @see     TreeMap
 160  * @see     Hashtable
 161  * @since   1.4
 162  */
 163 public class LinkedHashMap<K,V>


< prev index next >