Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(78)

Side by Side Diff: sdk/lib/core/list.dart

Issue 12817003: Change getRange to sublist. Make getRange deprecated. (Closed) Base URL: https://dart.googlecode.com/svn/branches/bleeding_edge/dart
Patch Set: Addressed review comments Created 7 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
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. 8 * A [List] is an indexable collection with a length.
9 * 9 *
10 * A `List` implementation can choose not to support all methods 10 * A `List` implementation can choose not to support all methods
(...skipping 207 matching lines...) Expand 10 before | Expand all | Expand 10 after
218 E removeAt(int index); 218 E removeAt(int index);
219 219
220 /** 220 /**
221 * Pops and returns the last element of the list. 221 * Pops and returns the last element of the list.
222 * Throws a [UnsupportedError] if the length of the 222 * Throws a [UnsupportedError] if the length of the
223 * list cannot be changed. 223 * list cannot be changed.
224 */ 224 */
225 E removeLast(); 225 E removeLast();
226 226
227 /** 227 /**
228 * Returns a new list containing [length] elements from the list, 228 * Returns a new list containing the elemenst from [start] to [end].
229 * starting at [start]. 229 *
230 * Returns an empty list if [length] is 0. 230 * If [end] is omitted, the [length] of the list is used.
231 * Throws an [ArgumentError] if [length] is negative. 231 *
232 * Throws an [RangeError] if [start] or 232 * It is an error if [start] or [end] are not list indices for this list,
233 * [:start + length - 1:] are out of range. 233 * or if [end] is before [start].
234 */ 234 */
235 List<E> sublist(int start, [int end]);
236
237 /**
238 * *Deprecated*. Use [sublist] instead.
239 */
240 @deprecated
235 List<E> getRange(int start, int length); 241 List<E> getRange(int start, int length);
236 242
237 /** 243 /**
238 * Copies [length] elements of [from], starting 244 * Copies [length] elements of [from], starting
239 * at [startFrom], into the list, starting at [start]. 245 * at [startFrom], into the list, starting at [start].
240 * If [length] is 0, this method does not do anything. 246 * If [length] is 0, this method does not do anything.
241 * Throws an [ArgumentError] if [length] is negative. 247 * Throws an [ArgumentError] if [length] is negative.
242 * Throws an [RangeError] if [start] or 248 * Throws an [RangeError] if [start] or
243 * [:start + length - 1:] are out of range for [:this:], or if 249 * [:start + length - 1:] are out of range for [:this:], or if
244 * [startFrom] or [:startFrom + length - 1:] are out of range for [from]. 250 * [startFrom] or [:startFrom + length - 1:] are out of range for [from].
(...skipping 26 matching lines...) Expand all
271 void insertRange(int start, int length, [E fill]); 277 void insertRange(int start, int length, [E fill]);
272 278
273 /** 279 /**
274 * Returns an unmodifiable [Map] view of `this`. 280 * Returns an unmodifiable [Map] view of `this`.
275 * 281 *
276 * It has the indices of this list as keys, and the corresponding elements 282 * It has the indices of this list as keys, and the corresponding elements
277 * as values. 283 * as values.
278 */ 284 */
279 Map<int, E> asMap(); 285 Map<int, E> asMap();
280 } 286 }
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698