public static class CharLists.SynchronizedList extends java.lang.Object implements CharList, java.io.Serializable
Modifier and Type | Method and Description |
---|---|
boolean |
add(char k)
Ensures that this collection contains the specified element (optional operation).
|
boolean |
add(java.lang.Character k)
Deprecated.
|
void |
add(int i,
char k)
Inserts the specified element at the specified position in this list (optional operation).
|
void |
add(int i,
java.lang.Character k)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
addAll(CharCollection c)
Adds all elements of the given type-specific collection to this collection.
|
boolean |
addAll(CharList l)
Appends all of the elements in the specified type-specific list to the end of this type-specific list (optional operation).
|
boolean |
addAll(java.util.Collection<? extends java.lang.Character> c) |
boolean |
addAll(int index,
CharCollection c)
Inserts all of the elements in the specified type-specific collection into this type-specific list at the specified position (optional operation).
|
boolean |
addAll(int index,
CharList l)
Inserts all of the elements in the specified type-specific list into this type-specific list at the specified position (optional operation).
|
boolean |
addAll(int index,
java.util.Collection<? extends java.lang.Character> c) |
void |
addElements(int index,
char[] a)
Add (hopefully quickly) elements to this type-specific list.
|
void |
addElements(int index,
char[] a,
int offset,
int length)
Add (hopefully quickly) elements to this type-specific list.
|
void |
clear() |
int |
compareTo(java.util.List<? extends java.lang.Character> o) |
boolean |
contains(char k)
Returns
true if this collection contains the specified element. |
boolean |
contains(java.lang.Object k)
Deprecated.
|
boolean |
containsAll(CharCollection c)
Checks whether this collection contains all elements from the given type-specific collection.
|
boolean |
containsAll(java.util.Collection<?> c) |
boolean |
equals(java.lang.Object o) |
void |
forEach(CharConsumer action)
Performs the given action for each element of this type-specific
Iterable
until all elements have been processed or the action throws an
exception. |
java.lang.Character |
get(int i)
Deprecated.
Please use the corresponding type-specific method instead.
|
char |
getChar(int i)
Returns the element at the specified position in this list.
|
void |
getElements(int from,
char[] a,
int offset,
int length)
Copies (hopefully quickly) elements of this type-specific list into the given array.
|
int |
hashCode() |
int |
indexOf(char k)
Returns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element.
|
int |
indexOf(java.lang.Object o)
Deprecated.
Please use the corresponding type-specific method instead.
|
IntIterator |
intIterator()
Returns a widened primitive iterator on the elements of this collection.
|
java.util.stream.IntStream |
intParallelStream()
Return a parallel primitive stream over the elements, performing widening casts if needed.
|
IntSpliterator |
intSpliterator()
Returns widened primitive spliterator on the elements of this collection.
|
java.util.stream.IntStream |
intStream()
Return a primitive stream over the elements, performing widening casts if needed.
|
boolean |
isEmpty() |
CharListIterator |
iterator()
Returns a type-specific iterator on the elements of this collection.
|
int |
lastIndexOf(char k)
Returns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.
|
int |
lastIndexOf(java.lang.Object o)
Deprecated.
Please use the corresponding type-specific method instead.
|
CharListIterator |
listIterator()
Returns a type-specific list iterator on the list.
|
CharListIterator |
listIterator(int i)
Returns a type-specific list iterator on the list starting at a given index.
|
java.util.stream.Stream<java.lang.Character> |
parallelStream()
Deprecated.
|
boolean |
rem(char k)
Removes a single instance of the specified element from this
collection, if it is present (optional operation).
|
java.lang.Character |
remove(int i)
Deprecated.
Please use the corresponding type-specific method instead.
|
boolean |
remove(java.lang.Object k)
Deprecated.
|
boolean |
removeAll(CharCollection c)
Remove from this collection all elements in the given type-specific collection.
|
boolean |
removeAll(java.util.Collection<?> c) |
char |
removeChar(int i)
Removes the element at the specified position in this list (optional operation).
|
void |
removeElements(int from,
int to)
Removes (hopefully quickly) elements of this type-specific list.
|
boolean |
removeIf(CharPredicate filter)
Remove from this collection all elements which satisfy the given predicate.
|
void |
replaceAll(CharUnaryOperator operator)
Replaces each element of this list with the result of applying the
operator to that element.
|
boolean |
retainAll(CharCollection c)
Retains in this collection only elements from the given type-specific collection.
|
boolean |
retainAll(java.util.Collection<?> c) |
char |
set(int i,
char k)
Replaces the element at the specified position in this list with the specified element (optional operation).
|
java.lang.Character |
set(int index,
java.lang.Character k)
Deprecated.
Please use the corresponding type-specific method instead.
|
void |
setElements(char[] a)
Set (hopefully quickly) elements to match the array given.
|
void |
setElements(int index,
char[] a)
Set (hopefully quickly) elements to match the array given.
|
void |
setElements(int index,
char[] a,
int offset,
int length)
Set (hopefully quickly) elements to match the array given.
|
int |
size() |
void |
size(int size)
Sets the size of this list.
|
void |
sort(CharComparator comparator)
Sort a list using a type-specific comparator.
|
void |
sort(java.util.Comparator<? super java.lang.Character> comparator)
Deprecated.
|
CharSpliterator |
spliterator()
Returns a type-specific spliterator on the elements of this collection.
|
java.util.stream.Stream<java.lang.Character> |
stream()
Deprecated.
|
CharList |
subList(int from,
int to)
Returns a type-specific view of the portion of this list from the index
from , inclusive, to the index to , exclusive. |
java.lang.Object[] |
toArray() |
char[] |
toArray(char[] a)
Returns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.
|
<T> T[] |
toArray(T[] a) |
char[] |
toCharArray()
Returns a primitive type array containing the items of this collection.
|
char[] |
toCharArray(char[] a)
Deprecated.
|
java.lang.String |
toString() |
void |
unstableSort(CharComparator comparator)
Sorts this list using a sort not assured to be stable.
|
void |
unstableSort(java.util.Comparator<? super java.lang.Character> comparator)
Deprecated.
|
add, add, contains, of, of, of, of, of, remove, replaceAll, replaceAll, spliterator
addAll, clear, containsAll, isEmpty, removeAll, retainAll, size, toArray, toArray
addAll, contains, containsAll, intIterator, intParallelStream, intSpliterator, intStream, parallelStream, rem, removeAll, removeIf, removeIf, retainAll, stream, toArray, toCharArray, toCharArray
forEach, forEach, forEach
public char getChar(int i)
CharList
public char set(int i, char k)
CharList
public void add(int i, char k)
CharList
public char removeChar(int i)
CharList
removeChar
in interface CharList
List.remove(int)
public int indexOf(char k)
CharList
public int lastIndexOf(char k)
CharList
lastIndexOf
in interface CharList
List.lastIndexOf(Object)
public boolean removeIf(CharPredicate filter)
CharCollection
removeIf
in interface CharCollection
filter
- a predicate which returns true
for elements to be
removed.true
if any elements were removed.Collection.removeIf(java.util.function.Predicate)
public void replaceAll(CharUnaryOperator operator)
CharList
replaceAll
in interface CharList
operator
- the operator to apply to each element.List.replaceAll(java.util.function.UnaryOperator<E>)
public boolean addAll(int index, java.util.Collection<? extends java.lang.Character> c)
addAll
in interface java.util.List<java.lang.Character>
public void getElements(int from, char[] a, int offset, int length)
CharList
getElements
in interface CharList
from
- the start index (inclusive).a
- the destination array.offset
- the offset into the destination array where to store the first element copied.length
- the number of elements to be copied.public void removeElements(int from, int to)
CharList
removeElements
in interface CharList
from
- the start index (inclusive).to
- the end index (exclusive).public void addElements(int index, char[] a, int offset, int length)
CharList
addElements
in interface CharList
index
- the index at which to add elements.a
- the array containing the elements.offset
- the offset of the first element to add.length
- the number of elements to add.public void addElements(int index, char[] a)
CharList
addElements
in interface CharList
index
- the index at which to add elements.a
- the array containing the elements.public void setElements(char[] a)
CharList
setElements
in interface CharList
a
- the array containing the elements.public void setElements(int index, char[] a)
CharList
setElements
in interface CharList
index
- the index at which to start setting elements.a
- the array containing the elements.public void setElements(int index, char[] a, int offset, int length)
CharList
ListIterator iter = listIterator(index);
int i = 0;
while (i < length) {
iter.next();
iter.set(a[offset + i++]);
}
However, the exact implementation may be more efficient, taking into account
whether random access is faster or not, or at the discretion of subclasses,
abuse internals.setElements
in interface CharList
index
- the index at which to start setting elements.a
- the array containing the elementsoffset
- the offset of the first element to add.length
- the number of elements to add.public void size(int size)
CharList
If the specified size is smaller than the current size, the last elements are
discarded. Otherwise, they are filled with 0/null
/false
.
public CharListIterator listIterator()
CharList
listIterator
in interface CharList
listIterator
in interface java.util.List<java.lang.Character>
List.listIterator()
public CharListIterator iterator()
CharCollection
iterator
in interface CharCollection
iterator
in interface CharIterable
iterator
in interface CharList
iterator
in interface java.lang.Iterable<java.lang.Character>
iterator
in interface java.util.Collection<java.lang.Character>
iterator
in interface java.util.List<java.lang.Character>
Iterable.iterator()
public CharListIterator listIterator(int i)
CharList
listIterator
in interface CharList
listIterator
in interface java.util.List<java.lang.Character>
List.listIterator(int)
public CharList subList(int from, int to)
CharList
from
, inclusive, to the index to
, exclusive.public boolean equals(java.lang.Object o)
equals
in interface java.util.Collection<java.lang.Character>
equals
in interface java.util.List<java.lang.Character>
public int hashCode()
hashCode
in interface java.util.Collection<java.lang.Character>
hashCode
in interface java.util.List<java.lang.Character>
public int compareTo(java.util.List<? extends java.lang.Character> o)
compareTo
in interface java.lang.Comparable<java.util.List<? extends java.lang.Character>>
public boolean addAll(int index, CharCollection c)
CharList
public boolean addAll(int index, CharList l)
CharList
public boolean addAll(CharList l)
CharList
@Deprecated public java.lang.Character get(int i)
@Deprecated public void add(int i, java.lang.Character k)
@Deprecated public java.lang.Character set(int index, java.lang.Character k)
@Deprecated public java.lang.Character remove(int i)
@Deprecated public int indexOf(java.lang.Object o)
@Deprecated public int lastIndexOf(java.lang.Object o)
lastIndexOf
in interface CharList
lastIndexOf
in interface java.util.List<java.lang.Character>
public void sort(CharComparator comparator)
CharList
Pass null
to sort using natural ordering.
public void unstableSort(CharComparator comparator)
CharList
Pass null
to sort using natural ordering.
This differs from List.sort(java.util.Comparator)
in that the results are
not assured to be stable, but may be a bit faster.
Unless a subclass specifies otherwise, the results of the method if the list is concurrently modified during the sort are unspecified.
unstableSort
in interface CharList
@Deprecated public void sort(java.util.Comparator<? super java.lang.Character> comparator)
CharList
@Deprecated public void unstableSort(java.util.Comparator<? super java.lang.Character> comparator)
CharList
unstableSort
in interface CharList
public boolean add(char k)
CharCollection
add
in interface CharCollection
Collection.add(Object)
public boolean contains(char k)
CharCollection
true
if this collection contains the specified element.contains
in interface CharCollection
Collection.contains(Object)
public boolean rem(char k)
CharCollection
Note that this method should be called remove()
, but the clash
with the similarly named index-based method in the List
interface
forces us to use a distinguished name. For simplicity, the set interfaces reinstates
remove()
.
rem
in interface CharCollection
Collection.remove(Object)
public int size()
size
in interface java.util.Collection<java.lang.Character>
public boolean isEmpty()
isEmpty
in interface java.util.Collection<java.lang.Character>
public char[] toCharArray()
CharCollection
toCharArray
in interface CharCollection
Collection.toArray()
public java.lang.Object[] toArray()
toArray
in interface java.util.Collection<java.lang.Character>
@Deprecated public char[] toCharArray(char[] a)
CharCollection
Note that, contrarily to Collection.toArray(Object[])
, this
methods just writes all elements of this collection: no special
value will be added after the last one.
toCharArray
in interface CharCollection
a
- if this array is big enough, it will be used to store this collection.Collection.toArray(Object[])
public char[] toArray(char[] a)
CharCollection
Note that, contrarily to Collection.toArray(Object[])
, this
methods just writes all elements of this collection: no special
value will be added after the last one.
toArray
in interface CharCollection
a
- if this array is big enough, it will be used to store this collection.Collection.toArray(Object[])
public boolean addAll(CharCollection c)
CharCollection
addAll
in interface CharCollection
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.addAll(Collection)
public boolean containsAll(CharCollection c)
CharCollection
containsAll
in interface CharCollection
c
- a type-specific collection.true
if this collection contains all elements of the argument.Collection.containsAll(Collection)
public boolean removeAll(CharCollection c)
CharCollection
removeAll
in interface CharCollection
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.removeAll(Collection)
public boolean retainAll(CharCollection c)
CharCollection
retainAll
in interface CharCollection
c
- a type-specific collection.true
if this collection changed as a result of the call.Collection.retainAll(Collection)
@Deprecated public boolean add(java.lang.Character k)
CharCollection
add
in interface CharCollection
add
in interface java.util.Collection<java.lang.Character>
@Deprecated public boolean contains(java.lang.Object k)
CharCollection
contains
in interface CharCollection
contains
in interface java.util.Collection<java.lang.Character>
@Deprecated public boolean remove(java.lang.Object k)
CharCollection
remove
in interface CharCollection
remove
in interface java.util.Collection<java.lang.Character>
public IntIterator intIterator()
CharCollection
This method is provided for the purpose of APIs that expect only the JDK's
primitive iterators, of which there are only int
, long
, and double
.
WARNING: This is not the same as converting the source to a sequence
of code points. This returned instance literally performs (int)(charValue)
casts.
Surrogate pairs will be left as separate elements instead of combined into a single element
with the code point it represents. See Character
for more discussion on code points,
char values, and surrogate pairs.
intIterator
in interface CharCollection
intIterator
in interface CharIterable
public IntSpliterator intSpliterator()
CharCollection
This method is provided for the purpose of APIs that expect only the JDK's
primitive spliterators, of which there are only int
, long
, and double
.
WARNING: This is not the same as converting the source to a sequence
of code points. This returned instance literally performs (int)(charValue)
casts.
Surrogate pairs will be left as separate elements instead of combined into a single element
with the code point it represents. See Character
for more discussion on code points,
char values, and surrogate pairs.
intSpliterator
in interface CharCollection
intSpliterator
in interface CharIterable
public java.util.stream.IntStream intStream()
CharCollection
WARNING: This is not the same as converting the source to a sequence
of code points. This returned instance literally performs (int)(charValue)
casts.
Surrogate pairs will be left as separate elements instead of combined into a single element
with the code point it represents. See Character
for more discussion on code points,
char values, and surrogate pairs.
intStream
in interface CharCollection
Collection.stream()
,
IntStream
public java.util.stream.IntStream intParallelStream()
CharCollection
WARNING: This is not the same as converting the source to a sequence
of code points. This returned instance literally performs (int)(charValue)
casts.
Surrogate pairs will be left as separate elements instead of combined into a single element
with the code point it represents. See Character
for more discussion on code points,
char values, and surrogate pairs.
intParallelStream
in interface CharCollection
Collection.parallelStream()
,
IntStream
public <T> T[] toArray(T[] a)
toArray
in interface java.util.Collection<java.lang.Character>
public CharSpliterator spliterator()
CharCollection
See Collection.spliterator()
for more documentation on the requirements
of the returned spliterator.
spliterator
in interface CharCollection
spliterator
in interface CharIterable
spliterator
in interface java.lang.Iterable<java.lang.Character>
spliterator
in interface java.util.Collection<java.lang.Character>
@Deprecated public java.util.stream.Stream<java.lang.Character> stream()
CharCollection
stream
in interface CharCollection
stream
in interface java.util.Collection<java.lang.Character>
@Deprecated public java.util.stream.Stream<java.lang.Character> parallelStream()
CharCollection
parallelStream
in interface CharCollection
parallelStream
in interface java.util.Collection<java.lang.Character>
public void forEach(CharConsumer action)
CharIterable
Iterable
until all elements have been processed or the action throws an
exception.forEach
in interface CharIterable
action
- the action to be performed for each element.Iterable.forEach(java.util.function.Consumer)
public boolean addAll(java.util.Collection<? extends java.lang.Character> c)
addAll
in interface java.util.Collection<java.lang.Character>
public boolean containsAll(java.util.Collection<?> c)
containsAll
in interface java.util.Collection<java.lang.Character>
public boolean removeAll(java.util.Collection<?> c)
removeAll
in interface java.util.Collection<java.lang.Character>
public boolean retainAll(java.util.Collection<?> c)
retainAll
in interface java.util.Collection<java.lang.Character>
public void clear()
clear
in interface java.util.Collection<java.lang.Character>
public java.lang.String toString()
toString
in class java.lang.Object