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); | |
225 } | 193 } |
OLD | NEW |