| 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 /** | 5 /** |
| 6 * A [List] is an indexable collection with a length. It can be of | 6 * A [List] is an indexable collection with a length. It can be of |
| 7 * fixed size or extendable. | 7 * fixed size or extendable. |
| 8 */ | 8 */ |
| 9 interface List<E> extends Collection<E>, Sequence<E> | 9 interface List<E> extends Collection<E>, Sequence<E> |
| 10 default _ListImpl<E> { | 10 default _ListImpl<E> { |
| (...skipping 105 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 116 E removeAt(int index); | 116 E removeAt(int index); |
| 117 | 117 |
| 118 /** | 118 /** |
| 119 * Pops and returns the last element of the list. | 119 * Pops and returns the last element of the list. |
| 120 * Throws a [UnsupportedError] if the length of the | 120 * Throws a [UnsupportedError] if the length of the |
| 121 * list cannot be changed. | 121 * list cannot be changed. |
| 122 */ | 122 */ |
| 123 E removeLast(); | 123 E removeLast(); |
| 124 | 124 |
| 125 /** | 125 /** |
| 126 * Returns the first element of the list, or throws an out of bounds |
| 127 * exception if the list is empty. |
| 128 */ |
| 129 E get first; |
| 130 |
| 131 /** |
| 126 * Returns the last element of the list, or throws an out of bounds | 132 * Returns the last element of the list, or throws an out of bounds |
| 127 * exception if the list is empty. | 133 * exception if the list is empty. |
| 128 */ | 134 */ |
| 129 E get last; | 135 E get last; |
| 130 | 136 |
| 131 /** | 137 /** |
| 132 * Returns a new list containing [length] elements from the list, | 138 * Returns a new list containing [length] elements from the list, |
| 133 * starting at [start]. | 139 * starting at [start]. |
| 134 * Returns an empty list if [length] is 0. | 140 * Returns an empty list if [length] is 0. |
| 135 * Throws an [ArgumentError] if [length] is negative. | 141 * Throws an [ArgumentError] if [length] is negative. |
| (...skipping 48 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 184 external factory List([int length]); | 190 external factory List([int length]); |
| 185 | 191 |
| 186 /** | 192 /** |
| 187 * Factory implementation of List.from(). | 193 * Factory implementation of List.from(). |
| 188 * | 194 * |
| 189 * Creates a list with the elements of [other]. The order in | 195 * Creates a list with the elements of [other]. The order in |
| 190 * the list will be the order provided by the iterator of [other]. | 196 * the list will be the order provided by the iterator of [other]. |
| 191 */ | 197 */ |
| 192 external factory List.from(Iterable<E> other); | 198 external factory List.from(Iterable<E> other); |
| 193 } | 199 } |
| OLD | NEW |