| OLD | NEW |
| 1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, 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> default ListFactory<E> { | 9 interface List<E> extends Collection<E> default ListFactory<E> { |
| 10 | 10 |
| (...skipping 103 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 114 * Returns an empty list if [length] is 0. | 114 * Returns an empty list if [length] is 0. |
| 115 * Throws an [IllegalArgumentException] if [length] is negative. | 115 * Throws an [IllegalArgumentException] if [length] is negative. |
| 116 * Throws an [IndexOutOfRangeException] if [start] or | 116 * Throws an [IndexOutOfRangeException] if [start] or |
| 117 * [:start + length:] are out of range. | 117 * [:start + length:] are out of range. |
| 118 */ | 118 */ |
| 119 List<E> getRange(int start, int length); | 119 List<E> getRange(int start, int length); |
| 120 | 120 |
| 121 /** | 121 /** |
| 122 * Copies [length] elements of the [from] array, starting | 122 * Copies [length] elements of the [from] array, starting |
| 123 * from [startFrom], into [:this:], starting at [start]. | 123 * from [startFrom], into [:this:], starting at [start]. |
| 124 * Throws an [UnsupportedOperationException] if the list is | |
| 125 * not extendable. | |
| 126 * If [length] is 0, this method does not do anything. | 124 * If [length] is 0, this method does not do anything. |
| 127 * Throws an [IllegalArgumentException] if [length] is negative. | 125 * Throws an [IllegalArgumentException] if [length] is negative. |
| 128 * Throws an [IndexOutOfRangeException] if [start] or | 126 * Throws an [IndexOutOfRangeException] if [start] or |
| 129 * [:start + length:] are out of range for [:this:], or if | 127 * [:start + length:] are out of range for [:this:], or if |
| 130 * [startFrom] is out of range for [from]. | 128 * [startFrom] is out of range for [from]. |
| 131 */ | 129 */ |
| 132 void setRange(int start, int length, List<E> from, [int startFrom]); | 130 void setRange(int start, int length, List<E> from, [int startFrom]); |
| 133 | 131 |
| 134 /** | 132 /** |
| 135 * Removes the range in the list starting from [start] to | 133 * Removes the range in the list starting from [start] to |
| (...skipping 14 matching lines...) Expand all Loading... |
| 150 * not extendable. | 148 * not extendable. |
| 151 * If [length] is 0, this method does not do anything. | 149 * If [length] is 0, this method does not do anything. |
| 152 * If [start] is the length of the array, this method inserts the | 150 * If [start] is the length of the array, this method inserts the |
| 153 * range at the end of the array. | 151 * range at the end of the array. |
| 154 * Throws an [IllegalArgumentException] if [length] is negative. | 152 * Throws an [IllegalArgumentException] if [length] is negative. |
| 155 * Throws an [IndexOutOfRangeException] if [start] or | 153 * Throws an [IndexOutOfRangeException] if [start] or |
| 156 * [:start + length:] are out of range. | 154 * [:start + length:] are out of range. |
| 157 */ | 155 */ |
| 158 void insertRange(int start, int length, [E initialValue]); | 156 void insertRange(int start, int length, [E initialValue]); |
| 159 } | 157 } |
| OLD | NEW |