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