| 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 values, or "elements", that can be accessed sequentially. | 8 * A collection of values, or "elements", that can be accessed sequentially. |
| 9 * | 9 * |
| 10 * The elements of the iterable are accessed by getting an [Iterator] | 10 * The elements of the iterable are accessed by getting an [Iterator] |
| (...skipping 128 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 139 */ | 139 */ |
| 140 Iterator<E> get iterator; | 140 Iterator<E> get iterator; |
| 141 | 141 |
| 142 /** | 142 /** |
| 143 * Returns a new lazy [Iterable] with elements that are created by | 143 * Returns a new lazy [Iterable] with elements that are created by |
| 144 * calling `f` on each element of this `Iterable` in iteration order. | 144 * calling `f` on each element of this `Iterable` in iteration order. |
| 145 * | 145 * |
| 146 * This method returns a view of the mapped elements. As long as the | 146 * This method returns a view of the mapped elements. As long as the |
| 147 * returned [Iterable] is not iterated over, the supplied function [f] will | 147 * returned [Iterable] is not iterated over, the supplied function [f] will |
| 148 * not be invoked. The transformed elements will not be cached. Iterating | 148 * not be invoked. The transformed elements will not be cached. Iterating |
| 149 * multiple times over the the returned [Iterable] will invoke the supplied | 149 * multiple times over the returned [Iterable] will invoke the supplied |
| 150 * function [f] multiple times on the same element. | 150 * function [f] multiple times on the same element. |
| 151 * | 151 * |
| 152 * Methods on the returned iterable are allowed to omit calling `f` | 152 * Methods on the returned iterable are allowed to omit calling `f` |
| 153 * on any element where the result isn't needed. | 153 * on any element where the result isn't needed. |
| 154 * For example, [elementAt] may call `f` only once. | 154 * For example, [elementAt] may call `f` only once. |
| 155 */ | 155 */ |
| 156 Iterable/*<T>*/ map/*<T>*/(/*=T*/ f(E e)) => | 156 Iterable/*<T>*/ map/*<T>*/(/*=T*/ f(E e)) => |
| 157 new MappedIterable<E, dynamic/*=T*/>(this, f); | 157 new MappedIterable<E, dynamic/*=T*/>(this, f); |
| 158 | 158 |
| 159 /** | 159 /** |
| (...skipping 513 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 673 */ | 673 */ |
| 674 abstract class BidirectionalIterator<E> implements Iterator<E> { | 674 abstract class BidirectionalIterator<E> implements Iterator<E> { |
| 675 /** | 675 /** |
| 676 * Move back to the previous element. | 676 * Move back to the previous element. |
| 677 * | 677 * |
| 678 * Returns true and updates [current] if successful. Returns false | 678 * Returns true and updates [current] if successful. Returns false |
| 679 * and sets [current] to null if there is no previous element. | 679 * and sets [current] to null if there is no previous element. |
| 680 */ | 680 */ |
| 681 bool movePrevious(); | 681 bool movePrevious(); |
| 682 } | 682 } |
| OLD | NEW |