OLD | NEW |
1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, 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._collection.dev; | 5 part of dart._collection.dev; |
6 | 6 |
7 /** | 7 /** |
8 * Base implementation of a [List] class. | |
9 * | |
10 * This class can be used as a mixin. | |
11 * | |
12 * This implements all read operations using only the `length` and | |
13 * `operator[]` members. It implements write operations using those and | |
14 * `length=` and `operator[]=` | |
15 * | |
16 * A fixed-length list should mix this class in, and the [FixedLengthListMixin] | |
17 * as well, in that order, to overwrite the methods that modify the length. | |
18 * | |
19 * An unmodifiable list should mix [UnmodifiableListMixin] on top of this | |
20 * mixin to prevent all modifications. | |
21 */ | |
22 abstract class ListMixin<E> implements List<E> { | |
23 // Iterable interface. | |
24 Iterator<E> get iterator => new ListIterator<E>(this); | |
25 | |
26 E elementAt(int index) => this[index]; | |
27 | |
28 void forEach(void action(E element)) { | |
29 int length = this.length; | |
30 for (int i = 0; i < length; i++) { | |
31 action(this[i]); | |
32 if (length != this.length) { | |
33 throw new ConcurrentModificationError(this); | |
34 } | |
35 } | |
36 } | |
37 | |
38 bool get isEmpty => length == 0; | |
39 | |
40 E get first { | |
41 if (length == 0) throw new StateError("No elements"); | |
42 return this[0]; | |
43 } | |
44 | |
45 E get last { | |
46 if (length == 0) throw new StateError("No elements"); | |
47 return this[length - 1]; | |
48 } | |
49 | |
50 E get single { | |
51 if (length == 0) throw new StateError("No elements"); | |
52 if (length > 1) throw new StateError("Too many elements"); | |
53 return this[0]; | |
54 } | |
55 | |
56 bool contains(E element) { | |
57 int length = this.length; | |
58 for (int i = 0; i < length; i++) { | |
59 if (this[i] == element) return true; | |
60 if (length != this.length) { | |
61 throw new ConcurrentModificationError(this); | |
62 } | |
63 } | |
64 return false; | |
65 } | |
66 | |
67 bool every(bool test(E element)) { | |
68 int length = this.length; | |
69 for (int i = 0; i < length; i++) { | |
70 if (!test(this[i])) return false; | |
71 if (length != this.length) { | |
72 throw new ConcurrentModificationError(this); | |
73 } | |
74 } | |
75 return true; | |
76 } | |
77 | |
78 bool any(bool test(E element)) { | |
79 int length = this.length; | |
80 for (int i = 0; i < length; i++) { | |
81 if (test(this[i])) return true; | |
82 if (length != this.length) { | |
83 throw new ConcurrentModificationError(this); | |
84 } | |
85 } | |
86 return false; | |
87 } | |
88 | |
89 E firstWhere(bool test(E element), { E orElse() }) { | |
90 int length = this.length; | |
91 for (int i = 0; i < length; i++) { | |
92 E element = this[i]; | |
93 if (test(element)) return element; | |
94 if (length != this.length) { | |
95 throw new ConcurrentModificationError(this); | |
96 } | |
97 } | |
98 if (orElse != null) return orElse(); | |
99 throw new StateError("No matching element"); | |
100 } | |
101 | |
102 E lastWhere(bool test(E element), { E orElse() }) { | |
103 int length = this.length; | |
104 for (int i = length - 1; i >= 0; i--) { | |
105 E element = this[i]; | |
106 if (test(element)) return element; | |
107 if (length != this.length) { | |
108 throw new ConcurrentModificationError(this); | |
109 } | |
110 } | |
111 if (orElse != null) return orElse(); | |
112 throw new StateError("No matching element"); | |
113 } | |
114 | |
115 E singleWhere(bool test(E element)) { | |
116 int length = this.length; | |
117 E match = null; | |
118 bool matchFound = false; | |
119 for (int i = 0; i < length; i++) { | |
120 E element = this[i]; | |
121 if (test(element)) { | |
122 if (matchFound) { | |
123 throw new StateError("More than one matching element"); | |
124 } | |
125 matchFound = true; | |
126 match = element; | |
127 } | |
128 if (length != this.length) { | |
129 throw new ConcurrentModificationError(this); | |
130 } | |
131 } | |
132 if (matchFound) return match; | |
133 throw new StateError("No matching element"); | |
134 } | |
135 | |
136 E min([int compare(E a, E b)]) { | |
137 if (length == 0) return null; | |
138 if (compare == null) { | |
139 var defaultCompare = Comparable.compare; | |
140 compare = defaultCompare; | |
141 } | |
142 E min = this[0]; | |
143 int length = this.length; | |
144 for (int i = 1; i < length; i++) { | |
145 E element = this[i]; | |
146 if (compare(min, element) > 0) { | |
147 min = element; | |
148 } | |
149 if (length != this.length) { | |
150 throw new ConcurrentModificationError(this); | |
151 } | |
152 } | |
153 return min; | |
154 } | |
155 | |
156 E max([int compare(E a, E b)]) { | |
157 if (length == 0) return null; | |
158 if (compare == null) { | |
159 var defaultCompare = Comparable.compare; | |
160 compare = defaultCompare; | |
161 } | |
162 E max = this[0]; | |
163 int length = this.length; | |
164 for (int i = 1; i < length; i++) { | |
165 E element = this[i]; | |
166 if (compare(max, element) < 0) { | |
167 max = element; | |
168 } | |
169 if (length != this.length) { | |
170 throw new ConcurrentModificationError(this); | |
171 } | |
172 } | |
173 return max; | |
174 } | |
175 | |
176 String join([String separator]) { | |
177 int length = this.length; | |
178 if (separator != null && !separator.isEmpty) { | |
179 if (length == 0) return ""; | |
180 String first = "${this[0]}"; | |
181 if (length != this.length) { | |
182 throw new ConcurrentModificationError(this); | |
183 } | |
184 StringBuffer buffer = new StringBuffer(first); | |
185 for (int i = 1; i < length; i++) { | |
186 buffer.write(separator); | |
187 buffer.write("${this[i]}"); | |
188 if (length != this.length) { | |
189 throw new ConcurrentModificationError(this); | |
190 } | |
191 } | |
192 return buffer.toString(); | |
193 } else { | |
194 StringBuffer buffer = new StringBuffer(); | |
195 for (int i = 0; i < length; i++) { | |
196 buffer.write("${this[i]}"); | |
197 if (length != this.length) { | |
198 throw new ConcurrentModificationError(this); | |
199 } | |
200 } | |
201 return buffer.toString(); | |
202 } | |
203 } | |
204 | |
205 Iterable<E> where(bool test(E element)) => new WhereIterable<E>(this, test); | |
206 | |
207 Iterable map(f(E element)) => new MappedListIterable(this, f); | |
208 | |
209 reduce(var initialValue, combine(var previousValue, E element)) { | |
210 return fold(initialValue, combine); | |
211 } | |
212 | |
213 fold(var initialValue, combine(var previousValue, E element)) { | |
214 var value = initialValue; | |
215 int length = this.length; | |
216 for (int i = 0; i < length; i++) { | |
217 value = combine(value, this[i]); | |
218 if (length != this.length) { | |
219 throw new ConcurrentModificationError(this); | |
220 } | |
221 } | |
222 return value; | |
223 } | |
224 | |
225 Iterable<E> skip(int count) => new SubListIterable(this, count, null); | |
226 | |
227 Iterable<E> skipWhile(bool test(E element)) { | |
228 return new SkipWhileIterable<E>(this, test); | |
229 } | |
230 | |
231 Iterable<E> take(int count) => new SubListIterable(this, 0, count); | |
232 | |
233 Iterable<E> takeWhile(bool test(E element)) { | |
234 return new TakeWhileIterable<E>(this, test); | |
235 } | |
236 | |
237 List<E> toList({ bool growable: true }) { | |
238 List<E> result; | |
239 if (growable) { | |
240 result = new List<E>()..length = length; | |
241 } else { | |
242 result = new List<E>(length); | |
243 } | |
244 for (int i = 0; i < length; i++) { | |
245 result[i] = this[i]; | |
246 } | |
247 return result; | |
248 } | |
249 | |
250 Set<E> toSet() { | |
251 Set<E> result = new Set<E>(); | |
252 for (int i = 0; i < length; i++) { | |
253 result.add(this[i]); | |
254 } | |
255 return result; | |
256 } | |
257 | |
258 // Collection interface. | |
259 void add(E element) { | |
260 this[this.length++] = element; | |
261 } | |
262 | |
263 void addAll(Iterable<E> iterable) { | |
264 for (E element in iterable) { | |
265 this[this.length++] = element; | |
266 } | |
267 } | |
268 | |
269 void remove(Object element) { | |
270 for (int i = 0; i < this.length; i++) { | |
271 if (this[i] == element) { | |
272 this.setRange(i, this.length - i - 1, this, i + 1); | |
273 this.length -= 1; | |
274 return; | |
275 } | |
276 } | |
277 } | |
278 | |
279 void removeAll(Iterable<Object> elements) { | |
280 if (elements is! Set) { | |
281 elements = elements.toSet(); | |
282 } | |
283 _filter(this, elements.contains, false); | |
284 } | |
285 | |
286 | |
287 void retainAll(Iterable<E> iterable) { | |
288 if (elements is! Set) { | |
289 elements = elements.toSet(); | |
290 } | |
291 _filter(this, elements.contains, true); | |
292 } | |
293 | |
294 void removeWhere(bool test(E element)) { | |
295 _filter(this, test, false); | |
296 } | |
297 | |
298 void retainWhere(bool test(E element)) { | |
299 _filter(this, test, true); | |
300 } | |
301 | |
302 static void _filter(List source, | |
303 bool test(var element), | |
304 bool retainMatching) { | |
305 List retained = []; | |
306 int length = source.length; | |
307 for (int i = 0; i < length; i++) { | |
308 var element = source[i]; | |
309 if (test(element) == retainMatching) { | |
310 retained.add(element); | |
311 } | |
312 if (length != source.length) { | |
313 throw new ConcurrentModificationError(source); | |
314 } | |
315 } | |
316 if (retained.length != source.length) { | |
317 source.setRange(0, retained.length, retained); | |
318 source.length = retained.length; | |
319 } | |
320 } | |
321 | |
322 // List interface. | |
323 | |
324 void sort([Comparator<E> compare]) { | |
325 Sort.sort(this, compare); | |
326 } | |
327 | |
328 Map<int, E> asMap() { | |
329 return new ListMapView(this); | |
330 } | |
331 | |
332 List<E> sublist(int start, [int end]) { | |
333 if (end == null) end = length; | |
334 if (start < 0 || start > this.length) { | |
335 throw new RangeError.range(start, 0, this.length); | |
336 } | |
337 if (end < start || end > this.length) { | |
338 throw new RangeError.range(end, start, this.length); | |
339 } | |
340 int length = end - start; | |
341 List<E> result = new List<E>()..length = length; | |
342 for (int i = 0; i < length; i++) { | |
343 result[i] = this[start + i]; | |
344 } | |
345 return result; | |
346 } | |
347 | |
348 List<E> getRange(int start, int length) => sublist(start, start + length); | |
349 | |
350 void insertRange(int start, int length, [E initialValue]) { | |
351 if (start < 0 || start > this.length) { | |
352 throw new RangeError.range(start, 0, this.length); | |
353 } | |
354 int oldLength = this.length; | |
355 int moveLength = oldLength - start; | |
356 this.length += length; | |
357 if (moveLength > 0) { | |
358 this.setRange(start + length, moveLength, this, start); | |
359 } | |
360 for (int i = 0; i < length; i++) { | |
361 this[start + i] = initialValue; | |
362 } | |
363 } | |
364 | |
365 void removeRange(int start, int length) { | |
366 if (start < 0 || start > this.length) { | |
367 throw new RangeError.range(start, 0, this.length); | |
368 } | |
369 if (length < 0 || start + length > this.length) { | |
370 throw new RangeError.range(length, 0, this.length - start); | |
371 } | |
372 int end = start + length; | |
373 setRange(start, this.length - end, this, end); | |
374 this.length -= length; | |
375 } | |
376 | |
377 void clearRange(int start, int length, [E fill]) { | |
378 for (int i = 0; i < length; i++) { | |
379 this[start + i] = fill; | |
380 } | |
381 } | |
382 | |
383 void setRange(int start, int length, List<E> from, [int startFrom]) { | |
384 if (start < 0 || start > this.length) { | |
385 throw new RangeError.range(start, 0, this.length); | |
386 } | |
387 if (length < 0 || start + length > this.length) { | |
388 throw new RangeError.range(length, 0, this.length - start); | |
389 } | |
390 if (startFrom == null) { | |
391 startFrom = 0; | |
392 } | |
393 if (startFrom < 0 || startFrom + length > from.length) { | |
394 throw new RangeError.range(startFrom, 0, from.length - length); | |
395 } | |
396 if (startFrom < start) { | |
397 // Copy backwards to ensure correct copy if [from] is this. | |
398 for (int i = length - 1; i >= 0; i--) { | |
399 this[start + i] = from[startFrom + i]; | |
400 } | |
401 } else { | |
402 for (int i = 0; i < length; i++) { | |
403 this[start + i] = from[startFrom + i]; | |
404 } | |
405 } | |
406 } | |
407 | |
408 int indexOf(E element, [int startIndex = 0]) { | |
409 if (startIndex >= this.length) { | |
410 return -1; | |
411 } | |
412 if (startIndex < 0) { | |
413 startIndex = 0; | |
414 } | |
415 for (int i = startIndex; i < this.length; i++) { | |
416 if (this[i] == element) { | |
417 return i; | |
418 } | |
419 } | |
420 return -1; | |
421 } | |
422 | |
423 /** | |
424 * Returns the last index in the list [a] of the given [element], starting | |
425 * the search at index [startIndex] to 0. | |
426 * Returns -1 if [element] is not found. | |
427 */ | |
428 int lastIndexOf(E element, [int startIndex]) { | |
429 if (startIndex == null) { | |
430 startIndex = this.length - 1; | |
431 } else { | |
432 if (startIndex < 0) { | |
433 return -1; | |
434 } | |
435 if (startIndex >= a.length) { | |
436 startIndex = a.length - 1; | |
437 } | |
438 } | |
439 for (int i = startIndex; i >= 0; i--) { | |
440 if (this[i] == element) { | |
441 return i; | |
442 } | |
443 } | |
444 return -1; | |
445 } | |
446 | |
447 Iterable<E> get reversed => new ReversedListIterable(this); | |
448 } | |
449 | |
450 /** | |
451 * Mixin that throws on the length changing operations of [List]. | 8 * Mixin that throws on the length changing operations of [List]. |
452 * | 9 * |
453 * Intended to mix-in on top of [ListMixin] for fixed-length lists. | 10 * Intended to mix-in on top of [ListMixin] for fixed-length lists. |
454 */ | 11 */ |
455 abstract class FixedLengthListMixin<E> { | 12 abstract class FixedLengthListMixin<E> { |
456 void set length(int newLength) { | 13 void set length(int newLength) { |
457 throw new UnsupportedError( | 14 throw new UnsupportedError( |
458 "Cannot change the length of a fixed-length list"); | 15 "Cannot change the length of a fixed-length list"); |
459 } | 16 } |
460 | 17 |
(...skipping 151 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
612 throw new UnsupportedError( | 169 throw new UnsupportedError( |
613 "Cannot remove from an unmodifiable list"); | 170 "Cannot remove from an unmodifiable list"); |
614 } | 171 } |
615 | 172 |
616 void insertRange(int start, int length, [E initialValue]) { | 173 void insertRange(int start, int length, [E initialValue]) { |
617 throw new UnsupportedError( | 174 throw new UnsupportedError( |
618 "Cannot insert range in an unmodifiable list"); | 175 "Cannot insert range in an unmodifiable list"); |
619 } | 176 } |
620 } | 177 } |
621 | 178 |
622 | |
623 /** | |
624 * Abstract implementation of a list. | |
625 * | |
626 * All operations are defined in terms of `length`, `operator[]`, | |
627 * `operator[]=` and `length=`, which need to be implemented. | |
628 */ | |
629 abstract class ListBase<E> extends ListMixin<E> implements List<E> {} | |
630 | |
631 /** | 179 /** |
632 * Abstract implementation of a fixed-length list. | 180 * Abstract implementation of a fixed-length list. |
633 * | 181 * |
634 * All operations are defined in terms of `length`, `operator[]` and | 182 * All operations are defined in terms of `length`, `operator[]` and |
635 * `operator[]=`, which need to be implemented. | 183 * `operator[]=`, which need to be implemented. |
636 */ | 184 */ |
637 abstract class FixedLengthListBase<E> extends ListBase<E> | 185 typedef FixedLengthListBase<E> = ListBase<E> with FixedLengthListMixin<E>; |
638 with FixedLengthListMixin<E> {} | |
639 | 186 |
640 /** | 187 /** |
641 * Abstract implementation of an unmodifiable list. | 188 * Abstract implementation of an unmodifiable list. |
642 * | 189 * |
643 * All operations are defined in terms of `length` and `operator[]`, | 190 * All operations are defined in terms of `length` and `operator[]`, |
644 * which need to be implemented. | 191 * which need to be implemented. |
645 */ | 192 */ |
646 abstract class UnmodifiableListBase<E> extends ListBase<E> | 193 typedef UnmodifiableListBase<E> = ListBase<E> with UnmodifiableListMixin<E>; |
647 with UnmodifiableListMixin<E> {} | |
648 | |
649 /** An empty fixed-length (and therefore unmodifiable) list. */ | |
650 class EmptyList<E> extends FixedLengthListBase<E> { | |
651 int get length => 0; | |
652 E operator[](int index) { throw new RangeError.value(index); } | |
653 void operator []=(int index, E value) { throw new RangeError.value(index); } | |
654 Iterable<E> skip(int count) => const EmptyIterable(); | |
655 Iterable<E> take(int count) => const EmptyIterable(); | |
656 Iterable<E> get reversed => const EmptyIterable(); | |
657 void sort([int compare(E a, E b)]) {} | |
658 } | |
659 | |
660 class ReversedListIterable<E> extends ListIterable<E> { | |
661 Iterable<E> _source; | |
662 ReversedListIterable(this._source); | |
663 | |
664 int get length => _source.length; | |
665 | |
666 E elementAt(int index) => _source.elementAt(_source.length - 1 - index); | |
667 } | |
668 | |
669 /** | |
670 * An [Iterable] of the UTF-16 code units of a [String] in index order. | |
671 */ | |
672 class CodeUnits extends UnmodifiableListBase<int> { | |
673 /** The string that this is the code units of. */ | |
674 String _string; | |
675 | |
676 CodeUnits(this._string); | |
677 | |
678 int get length => _string.length; | |
679 int operator[](int i) => _string.codeUnitAt(i); | |
680 } | |
681 | 194 |
682 class _ListIndicesIterable extends ListIterable<int> { | 195 class _ListIndicesIterable extends ListIterable<int> { |
683 List _backedList; | 196 List _backedList; |
684 | 197 |
685 _ListIndicesIterable(this._backedList); | 198 _ListIndicesIterable(this._backedList); |
686 | 199 |
687 int get length => _backedList.length; | 200 int get length => _backedList.length; |
688 int elementAt(int index) { | 201 int elementAt(int index) { |
689 if (index < 0 || index >= length) { | 202 if (index < 0 || index >= length) { |
690 throw new RangeError.range(index, 0, length); | 203 throw new RangeError.range(index, 0, length); |
(...skipping 36 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
727 } | 240 } |
728 | 241 |
729 E remove(int key) { | 242 E remove(int key) { |
730 throw new UnsupportedError("Cannot modify an unmodifiable map"); | 243 throw new UnsupportedError("Cannot modify an unmodifiable map"); |
731 } | 244 } |
732 | 245 |
733 void clear() { | 246 void clear() { |
734 throw new UnsupportedError("Cannot modify an unmodifiable map"); | 247 throw new UnsupportedError("Cannot modify an unmodifiable map"); |
735 } | 248 } |
736 } | 249 } |
| 250 |
| 251 class ReversedListIterable<E> extends ListIterable<E> { |
| 252 Iterable<E> _source; |
| 253 ReversedListIterable(this._source); |
| 254 |
| 255 int get length => _source.length; |
| 256 |
| 257 E elementAt(int index) => _source.elementAt(_source.length - 1 - index); |
| 258 } |
OLD | NEW |