Implement getRange (returning an Iterable).

sdk/lib/core/list.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 part of dart.core;
 
 /**
  * A [List] is an indexable collection with a length.
  *
  * A `List` implementation can choose not to support all methods
@@ skipping 204 matching lines @@
   E removeAt(int index);
 
   /**
    * Pops and returns the last element of the list.
    * Throws a [UnsupportedError] if the length of the
    * list cannot be changed.
    */
   E removeLast();
 
   /**
-   * Returns a new list containing the elemenst from [start] to [end].
+   * Returns a new list containing the elements from [start] to [end].
    *
    * If [end] is omitted, the [length] of the list is used.
    *
    * It is an error if [start] or [end] are not list indices for this list,
    * or if [end] is before [start].
    */
   List<E> sublist(int start, [int end]);
 
   /**
-   * *Deprecated*. Use [sublist] instead.
+   * Returns an [Iterable] that iterators over the elements in the range
+   * [start] to [end] (exclusive). The result of this function is backed by
+   * `this`.
+   *
+   * It is an error if [end] is before [start].
+   *
+   * It is an error if the [start] and [end] are not valid ranges at the time
+   * of the call to this method. The returned [Iterable] behaves similar to
+   * `skip(start).take(end - start)`. That is, it will not throw exceptions
+   * if `this` changes size.
+   *
+   * Example:
+   *
+   *     var list = [1, 2, 3, 4, 5];
+   *     var range = list.getRange(1, 4);
+   *     print(range.join(', '));  // => 2, 3, 4
+   *     list.length = 3;
+   *     print(range.join(', '));  // => 2, 3
    */
-  @deprecated
-  List<E> getRange(int start, int length);
+  Iterable<E> getRange(int start, int end);
 
   /**
    * Copies [length] elements of [from], starting
    * at [startFrom], into the list, starting at [start].
    * If [length] is 0, this method does not do anything.
    * Throws an [ArgumentError] if [length] is negative.
    * Throws an [RangeError] if [start] or
    * [:start + length - 1:] are out of range for [:this:], or if
    * [startFrom] or [:startFrom + length - 1:] are out of range for [from].
    */
@@ skipping 25 matching lines @@
   void insertRange(int start, int length, [E fill]);
 
   /**
    * Returns an unmodifiable [Map] view of `this`.
    *
    * It has the indices of this list as keys, and the corresponding elements
    * as values.
    */
   Map<int, E> asMap();
 }