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; | |
6 | |
7 /** | 5 /** |
8 * The [Iterable] interface allows to get an [Iterator] out of an | 6 * The [Iterable] interface allows to get an [Iterator] out of an |
9 * [Iterable] object. | 7 * [Iterable] object. |
10 * | 8 * |
11 * This interface is used by the for-in construct to iterate over an | 9 * This interface is used by the for-in construct to iterate over an |
12 * [Iterable] object. | 10 * [Iterable] object. |
13 * The for-in construct takes an [Iterable] object at the right-hand | 11 * The for-in construct takes an [Iterable] object at the right-hand |
14 * side, and calls its [iterator] method to get an [Iterator] on it. | 12 * side, and calls its [iterator] method to get an [Iterator] on it. |
15 * | 13 * |
16 * A user-defined class that implements the [Iterable] interface can | 14 * A user-defined class that implements the [Iterable] interface can |
17 * be used as the right-hand side of a for-in construct. | 15 * be used as the right-hand side of a for-in construct. |
18 */ | 16 */ |
19 abstract class Iterable<E> { | 17 abstract class Iterable<E> { |
20 /** | 18 /** |
21 * Returns an [Iterator] that iterates over this [Iterable] object. | 19 * Returns an [Iterator] that iterates over this [Iterable] object. |
22 */ | 20 */ |
23 Iterator<E> iterator(); | 21 Iterator<E> iterator(); |
24 } | 22 } |
OLD | NEW |