70 |
|
* |
71 |
|
* <p>As of the Java 2 platform v1.2, this class was retrofitted to |
72 |
|
* implement the {@link List} interface, making it a member of the |
73 |
< |
* <a href="{@docRoot}/../technotes/guides/collections/index.html"> |
73 |
> |
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> |
74 |
|
* Java Collections Framework</a>. Unlike the new collection |
75 |
|
* implementations, {@code Vector} is synchronized. If a thread-safe |
76 |
|
* implementation is not needed, it is recommended to use {@link |
306 |
|
modCount++; |
307 |
|
if (newSize > elementData.length) |
308 |
|
grow(newSize); |
309 |
< |
for (int i = newSize; i < elementCount; i++) |
310 |
< |
elementData[i] = null; |
309 |
> |
final Object[] es = elementData; |
310 |
> |
for (int to = elementCount, i = newSize; i < to; i++) |
311 |
> |
es[i] = null; |
312 |
|
elementCount = newSize; |
313 |
|
} |
314 |
|
|
586 |
|
modCount++; |
587 |
|
elementCount--; |
588 |
|
elementData[elementCount] = null; /* to let gc do its work */ |
589 |
+ |
// checkInvariants(); |
590 |
|
} |
591 |
|
|
592 |
|
/** |
677 |
|
* method (which is part of the {@link List} interface). |
678 |
|
*/ |
679 |
|
public synchronized void removeAllElements() { |
680 |
< |
// Let gc do its work |
681 |
< |
for (int i = 0; i < elementCount; i++) |
682 |
< |
elementData[i] = null; |
681 |
< |
|
680 |
> |
final Object[] es = elementData; |
681 |
> |
for (int to = elementCount, i = elementCount = 0; i < to; i++) |
682 |
> |
es[i] = null; |
683 |
|
modCount++; |
683 |
– |
elementCount = 0; |
684 |
|
} |
685 |
|
|
686 |
|
/** |
810 |
|
elementData = grow(); |
811 |
|
elementData[s] = e; |
812 |
|
elementCount = s + 1; |
813 |
+ |
// checkInvariants(); |
814 |
|
} |
815 |
|
|
816 |
|
/** |
879 |
|
numMoved); |
880 |
|
elementData[--elementCount] = null; // Let gc do its work |
881 |
|
|
882 |
+ |
// checkInvariants(); |
883 |
|
return oldValue; |
884 |
|
} |
885 |
|
|
935 |
|
elementData = grow(s + numNew); |
936 |
|
System.arraycopy(a, 0, elementData, s, numNew); |
937 |
|
elementCount = s + numNew; |
938 |
+ |
// checkInvariants(); |
939 |
|
return true; |
940 |
|
} |
941 |
|
} |
986 |
|
return bulkRemove(e -> !c.contains(e)); |
987 |
|
} |
988 |
|
|
989 |
+ |
/** |
990 |
+ |
* @throws NullPointerException {@inheritDoc} |
991 |
+ |
*/ |
992 |
|
@Override |
993 |
|
public boolean removeIf(Predicate<? super E> filter) { |
994 |
|
Objects.requireNonNull(filter); |
1011 |
|
int expectedModCount = modCount; |
1012 |
|
final Object[] es = elementData; |
1013 |
|
final int end = elementCount; |
1008 |
– |
final boolean modified; |
1014 |
|
int i; |
1015 |
|
// Optimize for initial run of survivors |
1016 |
|
for (i = 0; i < end && !filter.test(elementAt(es, i)); i++) |
1018 |
|
// Tolerate predicates that reentrantly access the collection for |
1019 |
|
// read (but writers still get CME), so traverse once to find |
1020 |
|
// elements to delete, a second pass to physically expunge. |
1021 |
< |
if (modified = (i < end)) { |
1017 |
< |
expectedModCount++; |
1018 |
< |
modCount++; |
1021 |
> |
if (i < end) { |
1022 |
|
final int beg = i; |
1023 |
|
final long[] deathRow = nBits(end - beg); |
1024 |
|
deathRow[0] = 1L; // set bit 0 |
1025 |
|
for (i = beg + 1; i < end; i++) |
1026 |
|
if (filter.test(elementAt(es, i))) |
1027 |
|
setBit(deathRow, i - beg); |
1028 |
+ |
if (modCount != expectedModCount) |
1029 |
+ |
throw new ConcurrentModificationException(); |
1030 |
+ |
expectedModCount++; |
1031 |
+ |
modCount++; |
1032 |
|
int w = beg; |
1033 |
|
for (i = beg; i < end; i++) |
1034 |
|
if (isClear(deathRow, i - beg)) |
1035 |
|
es[w++] = es[i]; |
1036 |
< |
Arrays.fill(es, elementCount = w, end, null); |
1036 |
> |
for (i = elementCount = w; i < end; i++) |
1037 |
> |
es[i] = null; |
1038 |
> |
// checkInvariants(); |
1039 |
> |
return true; |
1040 |
> |
} else { |
1041 |
> |
if (modCount != expectedModCount) |
1042 |
> |
throw new ConcurrentModificationException(); |
1043 |
> |
// checkInvariants(); |
1044 |
> |
return false; |
1045 |
|
} |
1031 |
– |
if (modCount != expectedModCount) |
1032 |
– |
throw new ConcurrentModificationException(); |
1033 |
– |
return modified; |
1046 |
|
} |
1047 |
|
|
1048 |
|
/** |
1083 |
|
numMoved); |
1084 |
|
System.arraycopy(a, 0, elementData, index, numNew); |
1085 |
|
elementCount = s + numNew; |
1086 |
+ |
// checkInvariants(); |
1087 |
|
return true; |
1088 |
|
} |
1089 |
|
|
1165 |
|
* (If {@code toIndex==fromIndex}, this operation has no effect.) |
1166 |
|
*/ |
1167 |
|
protected synchronized void removeRange(int fromIndex, int toIndex) { |
1155 |
– |
int numMoved = elementCount - toIndex; |
1156 |
– |
System.arraycopy(elementData, toIndex, elementData, fromIndex, |
1157 |
– |
numMoved); |
1158 |
– |
|
1159 |
– |
// Let gc do its work |
1168 |
|
modCount++; |
1169 |
< |
int newElementCount = elementCount - (toIndex-fromIndex); |
1170 |
< |
while (elementCount != newElementCount) |
1171 |
< |
elementData[--elementCount] = null; |
1169 |
> |
shiftTailOverGap(elementData, fromIndex, toIndex); |
1170 |
> |
// checkInvariants(); |
1171 |
> |
} |
1172 |
> |
|
1173 |
> |
/** Erases the gap from lo to hi, by sliding down following elements. */ |
1174 |
> |
private void shiftTailOverGap(Object[] es, int lo, int hi) { |
1175 |
> |
System.arraycopy(es, hi, es, lo, elementCount - hi); |
1176 |
> |
for (int to = elementCount, i = (elementCount -= hi - lo); i < to; i++) |
1177 |
> |
es[i] = null; |
1178 |
|
} |
1179 |
|
|
1180 |
|
/** |
1181 |
< |
* Save the state of the {@code Vector} instance to a stream (that |
1182 |
< |
* is, serialize it). |
1181 |
> |
* Saves the state of the {@code Vector} instance to a stream |
1182 |
> |
* (that is, serializes it). |
1183 |
|
* This method performs synchronization to ensure the consistency |
1184 |
|
* of the serialized data. |
1185 |
+ |
* |
1186 |
+ |
* @param s the stream |
1187 |
+ |
* @throws java.io.IOException if an I/O error occurs |
1188 |
|
*/ |
1189 |
|
private void writeObject(java.io.ObjectOutputStream s) |
1190 |
|
throws java.io.IOException { |
1357 |
|
} |
1358 |
|
} |
1359 |
|
|
1360 |
+ |
/** |
1361 |
+ |
* @throws NullPointerException {@inheritDoc} |
1362 |
+ |
*/ |
1363 |
|
@Override |
1364 |
|
public synchronized void forEach(Consumer<? super E> action) { |
1365 |
|
Objects.requireNonNull(action); |
1370 |
|
action.accept(elementAt(es, i)); |
1371 |
|
if (modCount != expectedModCount) |
1372 |
|
throw new ConcurrentModificationException(); |
1373 |
+ |
// checkInvariants(); |
1374 |
|
} |
1375 |
|
|
1376 |
+ |
/** |
1377 |
+ |
* @throws NullPointerException {@inheritDoc} |
1378 |
+ |
*/ |
1379 |
|
@Override |
1380 |
|
public synchronized void replaceAll(UnaryOperator<E> operator) { |
1381 |
|
Objects.requireNonNull(operator); |
1387 |
|
if (modCount != expectedModCount) |
1388 |
|
throw new ConcurrentModificationException(); |
1389 |
|
modCount++; |
1390 |
+ |
// checkInvariants(); |
1391 |
|
} |
1392 |
|
|
1393 |
|
@SuppressWarnings("unchecked") |
1395 |
|
public synchronized void sort(Comparator<? super E> c) { |
1396 |
|
final int expectedModCount = modCount; |
1397 |
|
Arrays.sort((E[]) elementData, 0, elementCount, c); |
1398 |
< |
if (modCount != expectedModCount) { |
1398 |
> |
if (modCount != expectedModCount) |
1399 |
|
throw new ConcurrentModificationException(); |
1375 |
– |
} |
1400 |
|
modCount++; |
1401 |
+ |
// checkInvariants(); |
1402 |
|
} |
1403 |
|
|
1404 |
|
/** |
1416 |
|
*/ |
1417 |
|
@Override |
1418 |
|
public Spliterator<E> spliterator() { |
1419 |
< |
return new VectorSpliterator<>(this, null, 0, -1, 0); |
1419 |
> |
return new VectorSpliterator(null, 0, -1, 0); |
1420 |
|
} |
1421 |
|
|
1422 |
|
/** Similar to ArrayList Spliterator */ |
1423 |
< |
static final class VectorSpliterator<E> implements Spliterator<E> { |
1399 |
< |
private final Vector<E> list; |
1423 |
> |
final class VectorSpliterator implements Spliterator<E> { |
1424 |
|
private Object[] array; |
1425 |
|
private int index; // current index, modified on advance/split |
1426 |
|
private int fence; // -1 until used; then one past last index |
1427 |
|
private int expectedModCount; // initialized when fence set |
1428 |
|
|
1429 |
< |
/** Create new spliterator covering the given range */ |
1430 |
< |
VectorSpliterator(Vector<E> list, Object[] array, int origin, int fence, |
1429 |
> |
/** Creates new spliterator covering the given range. */ |
1430 |
> |
VectorSpliterator(Object[] array, int origin, int fence, |
1431 |
|
int expectedModCount) { |
1408 |
– |
this.list = list; |
1432 |
|
this.array = array; |
1433 |
|
this.index = origin; |
1434 |
|
this.fence = fence; |
1438 |
|
private int getFence() { // initialize on first use |
1439 |
|
int hi; |
1440 |
|
if ((hi = fence) < 0) { |
1441 |
< |
synchronized (list) { |
1442 |
< |
array = list.elementData; |
1443 |
< |
expectedModCount = list.modCount; |
1444 |
< |
hi = fence = list.elementCount; |
1441 |
> |
synchronized (Vector.this) { |
1442 |
> |
array = elementData; |
1443 |
> |
expectedModCount = modCount; |
1444 |
> |
hi = fence = elementCount; |
1445 |
|
} |
1446 |
|
} |
1447 |
|
return hi; |
1450 |
|
public Spliterator<E> trySplit() { |
1451 |
|
int hi = getFence(), lo = index, mid = (lo + hi) >>> 1; |
1452 |
|
return (lo >= mid) ? null : |
1453 |
< |
new VectorSpliterator<>(list, array, lo, index = mid, |
1431 |
< |
expectedModCount); |
1453 |
> |
new VectorSpliterator(array, lo, index = mid, expectedModCount); |
1454 |
|
} |
1455 |
|
|
1456 |
|
@SuppressWarnings("unchecked") |
1457 |
|
public boolean tryAdvance(Consumer<? super E> action) { |
1458 |
+ |
Objects.requireNonNull(action); |
1459 |
|
int i; |
1437 |
– |
if (action == null) |
1438 |
– |
throw new NullPointerException(); |
1460 |
|
if (getFence() > (i = index)) { |
1461 |
|
index = i + 1; |
1462 |
|
action.accept((E)array[i]); |
1463 |
< |
if (list.modCount != expectedModCount) |
1463 |
> |
if (modCount != expectedModCount) |
1464 |
|
throw new ConcurrentModificationException(); |
1465 |
|
return true; |
1466 |
|
} |
1469 |
|
|
1470 |
|
@SuppressWarnings("unchecked") |
1471 |
|
public void forEachRemaining(Consumer<? super E> action) { |
1472 |
< |
int i, hi; // hoist accesses and checks from loop |
1473 |
< |
Vector<E> lst; Object[] a; |
1474 |
< |
if (action == null) |
1475 |
< |
throw new NullPointerException(); |
1476 |
< |
if ((lst = list) != null) { |
1477 |
< |
if ((hi = fence) < 0) { |
1478 |
< |
synchronized (lst) { |
1479 |
< |
expectedModCount = lst.modCount; |
1459 |
< |
a = array = lst.elementData; |
1460 |
< |
hi = fence = lst.elementCount; |
1461 |
< |
} |
1462 |
< |
} |
1463 |
< |
else |
1464 |
< |
a = array; |
1465 |
< |
if (a != null && (i = index) >= 0 && (index = hi) <= a.length) { |
1466 |
< |
while (i < hi) |
1467 |
< |
action.accept((E) a[i++]); |
1468 |
< |
if (lst.modCount == expectedModCount) |
1469 |
< |
return; |
1470 |
< |
} |
1471 |
< |
} |
1472 |
< |
throw new ConcurrentModificationException(); |
1472 |
> |
Objects.requireNonNull(action); |
1473 |
> |
final int hi = getFence(); |
1474 |
> |
final Object[] a = array; |
1475 |
> |
int i; |
1476 |
> |
for (i = index, index = hi; i < hi; i++) |
1477 |
> |
action.accept((E) a[i]); |
1478 |
> |
if (modCount != expectedModCount) |
1479 |
> |
throw new ConcurrentModificationException(); |
1480 |
|
} |
1481 |
|
|
1482 |
|
public long estimateSize() { |
1487 |
|
return Spliterator.ORDERED | Spliterator.SIZED | Spliterator.SUBSIZED; |
1488 |
|
} |
1489 |
|
} |
1490 |
+ |
|
1491 |
+ |
void checkInvariants() { |
1492 |
+ |
// assert elementCount >= 0; |
1493 |
+ |
// assert elementCount == elementData.length || elementData[elementCount] == null; |
1494 |
+ |
} |
1495 |
|
} |