OLD | NEW |
1 // Copyright (c) 2012, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2012, 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 [List] is an indexable collection with a length. It can be of | 8 * A [List] is an indexable collection with a length. It can be of |
9 * fixed size or extendable. | 9 * fixed size or extendable. |
10 */ | 10 */ |
(...skipping 172 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
183 * Throws an [UnsupportedError] if the list is | 183 * Throws an [UnsupportedError] if the list is |
184 * not extendable. | 184 * not extendable. |
185 * If [length] is 0, this method does not do anything. | 185 * If [length] is 0, this method does not do anything. |
186 * If [start] is the length of the list, this method inserts the | 186 * If [start] is the length of the list, this method inserts the |
187 * range at the end of the list. | 187 * range at the end of the list. |
188 * Throws an [ArgumentError] if [length] is negative. | 188 * Throws an [ArgumentError] if [length] is negative. |
189 * Throws an [RangeError] if [start] is negative or if | 189 * Throws an [RangeError] if [start] is negative or if |
190 * [start] is greater than the length of the list. | 190 * [start] is greater than the length of the list. |
191 */ | 191 */ |
192 void insertRange(int start, int length, [E fill]); | 192 void insertRange(int start, int length, [E fill]); |
| 193 |
| 194 /** |
| 195 * Returns a lazy unmodifiable [List] where each element [:e:] of [:this:] is |
| 196 * replaced by the result of [:f(e):]. |
| 197 * |
| 198 * This method returns a view of the mapped elements. As long as the |
| 199 * returned [List] is not indexed or iterated over, the supplied function [f] |
| 200 * will not be invoked. The transformed elements will not be cached. Accessing |
| 201 * elements multiple times will invoke the supplied function [f] multiple |
| 202 * times. |
| 203 */ |
| 204 List mappedBy(f(E element)); |
| 205 |
| 206 /** |
| 207 * Returns an unmodifiable [List] that hides the first [n] elements. |
| 208 * |
| 209 * The returned list is a view backed by [:this:]. |
| 210 * |
| 211 * While [:this:] has fewer than [n] elements, then the resulting [List] |
| 212 * will be empty. |
| 213 */ |
| 214 List<E> skip(int n); |
| 215 |
| 216 /** |
| 217 * Returns an unmodifiable [List] with at most [n] elements. |
| 218 * |
| 219 * The returned list is a view backed by this. |
| 220 * |
| 221 * The returned [List] may contain fewer than [n] elements, while [:this:] |
| 222 * contains fewer than [n] elements. |
| 223 */ |
| 224 List<E> take(int n); |
193 } | 225 } |
OLD | NEW |