| OLD | NEW |
| 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 part of dart.core; | 5 part of dart.core; |
| 6 | 6 |
| 7 /** | 7 /** |
| 8 * A collection of objects in which each object can occur only once. | 8 * A collection of objects in which each object can occur only once. |
| 9 * | 9 * |
| 10 * That is, for each object of the element type, the object is either considered | 10 * That is, for each object of the element type, the object is either considered |
| (...skipping 13 matching lines...) Expand all Loading... |
| 24 * uspecified, | 24 * uspecified, |
| 25 * * [LinkedHashSet] iterates in the insertion order of its elements, and | 25 * * [LinkedHashSet] iterates in the insertion order of its elements, and |
| 26 * * a sorted set like [SplayTreeSet] iterates the elements in sorted order. | 26 * * a sorted set like [SplayTreeSet] iterates the elements in sorted order. |
| 27 * | 27 * |
| 28 * It is generally not allowed to modify the set (add or remove elements) while | 28 * It is generally not allowed to modify the set (add or remove elements) while |
| 29 * an operation on the set is being performed, for example during a call to | 29 * an operation on the set is being performed, for example during a call to |
| 30 * [forEach] or [containsAll]. Nor is it allowed to modify the set while | 30 * [forEach] or [containsAll]. Nor is it allowed to modify the set while |
| 31 * iterating either the set itself or any [Iterable] that is backed by the set, | 31 * iterating either the set itself or any [Iterable] that is backed by the set, |
| 32 * such as the ones returned by methods like [where] and [map]. | 32 * such as the ones returned by methods like [where] and [map]. |
| 33 */ | 33 */ |
| 34 abstract class Set<E> implements EfficientLengthIterable<E> { | 34 abstract class Set<E> extends Iterable<E> implements EfficientLength { |
| 35 /** | 35 /** |
| 36 * Creates an empty [Set]. | 36 * Creates an empty [Set]. |
| 37 * | 37 * |
| 38 * The created [Set] is a plain [LinkedHashSet]. | 38 * The created [Set] is a plain [LinkedHashSet]. |
| 39 * As such, it considers elements that are equal (using [==]) to be | 39 * As such, it considers elements that are equal (using [==]) to be |
| 40 * indistinguishable, and requires them to have a compatible | 40 * indistinguishable, and requires them to have a compatible |
| 41 * [Object.hashCode] implementation. | 41 * [Object.hashCode] implementation. |
| 42 * | 42 * |
| 43 * The set is equivalent to one created by `new LinkedHashSet<E>()`. | 43 * The set is equivalent to one created by `new LinkedHashSet<E>()`. |
| 44 */ | 44 */ |
| (...skipping 134 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 179 /* Creates a [Set] with the same elements and behavior as this `Set`. | 179 /* Creates a [Set] with the same elements and behavior as this `Set`. |
| 180 * | 180 * |
| 181 * The returned set behaves the same as this set | 181 * The returned set behaves the same as this set |
| 182 * with regard to adding and removing elements. | 182 * with regard to adding and removing elements. |
| 183 * It initially contains the same elements. | 183 * It initially contains the same elements. |
| 184 * If this set specifies an ordering of the elements, | 184 * If this set specifies an ordering of the elements, |
| 185 * the returned set will have the same order. | 185 * the returned set will have the same order. |
| 186 */ | 186 */ |
| 187 Set<E> toSet(); | 187 Set<E> toSet(); |
| 188 } | 188 } |
| OLD | NEW |