Class CharLists.UnmodifiableList
- All Implemented Interfaces:
CharCollection,CharIterable,CharList,java.io.Serializable,java.lang.Comparable<java.util.List<? extends java.lang.Character>>,java.lang.Iterable<java.lang.Character>,java.util.Collection<java.lang.Character>,java.util.List<java.lang.Character>
- Direct Known Subclasses:
CharLists.UnmodifiableRandomAccessList
- Enclosing class:
- CharLists
public static class CharLists.UnmodifiableList extends java.lang.Object implements CharList, java.io.Serializable
- See Also:
- Serialized Form
-
Method Summary
Modifier and Type Method Description booleanadd(char k)Ensures that this collection contains the specified element (optional operation).voidadd(int i, char k)Inserts the specified element at the specified position in this list (optional operation).voidadd(int i, java.lang.Character k)Deprecated.Please use the corresponding type-specific method instead.booleanadd(java.lang.Character k)Deprecated.booleanaddAll(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).booleanaddAll(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).booleanaddAll(int index, java.util.Collection<? extends java.lang.Character> c)booleanaddAll(CharCollection c)Adds all elements of the given type-specific collection to this collection.booleanaddAll(CharList l)Appends all of the elements in the specified type-specific list to the end of this type-specific list (optional operation).booleanaddAll(java.util.Collection<? extends java.lang.Character> c)voidaddElements(int index, char[] a)Add (hopefully quickly) elements to this type-specific list.voidaddElements(int index, char[] a, int offset, int length)Add (hopefully quickly) elements to this type-specific list.voidclear()intcompareTo(java.util.List<? extends java.lang.Character> o)booleancontains(char o)Returnstrueif this collection contains the specified element.booleancontains(java.lang.Object k)Deprecated.booleancontainsAll(CharCollection c)Checks whether this collection contains all elements from the given type-specific collection.booleancontainsAll(java.util.Collection<?> c)booleanequals(java.lang.Object o)voidforEach(CharConsumer action)Performs the given action for each element of this type-specificIterableuntil all elements have been processed or the action throws an exception.java.lang.Characterget(int i)Deprecated.Please use the corresponding type-specific method instead.chargetChar(int i)Returns the element at the specified position in this list.voidgetElements(int from, char[] a, int offset, int length)Copies (hopefully quickly) elements of this type-specific list into the given array.inthashCode()intindexOf(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.intindexOf(java.lang.Object o)Deprecated.Please use the corresponding type-specific method instead.IntIteratorintIterator()Returns a widened primitive iterator on the elements of this collection.java.util.stream.IntStreamintParallelStream()Return a parallel primitive stream over the elements, performing widening casts if needed.IntSpliteratorintSpliterator()Returns widened primitive spliterator on the elements of this collection.java.util.stream.IntStreamintStream()Return a primitive stream over the elements, performing widening casts if needed.booleanisEmpty()CharListIteratoriterator()Returns a type-specific iterator on the elements of this collection.intlastIndexOf(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.intlastIndexOf(java.lang.Object o)Deprecated.Please use the corresponding type-specific method instead.CharListIteratorlistIterator()Returns a type-specific list iterator on the list.CharListIteratorlistIterator(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.booleanrem(char k)Removes a single instance of the specified element from this collection, if it is present (optional operation).java.lang.Characterremove(int i)Deprecated.Please use the corresponding type-specific method instead.booleanremove(java.lang.Object k)Deprecated.booleanremoveAll(CharCollection c)Remove from this collection all elements in the given type-specific collection.booleanremoveAll(java.util.Collection<?> c)charremoveChar(int i)Removes the element at the specified position in this list (optional operation).voidremoveElements(int from, int to)Removes (hopefully quickly) elements of this type-specific list.booleanremoveIf(CharPredicate filter)Remove from this collection all elements which satisfy the given predicate.voidreplaceAll(java.util.function.IntUnaryOperator operator)Replaces each element of this list with the result of applying the operator to that element, performing widening and narrowing primitive casts, until all elements have been processed or the action throws an exception.voidreplaceAll(java.util.function.UnaryOperator<java.lang.Character> operator)Deprecated.booleanretainAll(CharCollection c)Retains in this collection only elements from the given type-specific collection.booleanretainAll(java.util.Collection<?> c)charset(int i, char k)Replaces the element at the specified position in this list with the specified element (optional operation).java.lang.Characterset(int index, java.lang.Character k)Deprecated.Please use the corresponding type-specific method instead.voidsetElements(char[] a)Set (hopefully quickly) elements to match the array given.voidsetElements(int index, char[] a)Set (hopefully quickly) elements to match the array given.voidsetElements(int index, char[] a, int offset, int length)Set (hopefully quickly) elements to match the array given.intsize()voidsize(int size)Sets the size of this list.voidsort(CharComparator comparator)Sort a list using a type-specific comparator.voidsort(java.util.Comparator<? super java.lang.Character> comparator)Deprecated.CharSpliteratorspliterator()Returns a type-specific spliterator on the elements of this collection.java.util.stream.Stream<java.lang.Character>stream()Deprecated.CharListsubList(int from, int to)Returns a type-specific view of the portion of this list from the indexfrom, inclusive, to the indexto, 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.StringtoString()voidunstableSort(CharComparator comparator)Sorts this list using a sort not assured to be stable.voidunstableSort(java.util.Comparator<? super java.lang.Character> comparator)Deprecated.Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface it.unimi.dsi.fastutil.chars.CharCollection
addAll, contains, containsAll, intIterator, intParallelStream, intSpliterator, intStream, parallelStream, rem, removeAll, removeIf, removeIf, removeIf, retainAll, stream, toArray, toCharArray, toCharArrayMethods inherited from interface it.unimi.dsi.fastutil.chars.CharIterable
forEach, forEach, forEachMethods inherited from interface it.unimi.dsi.fastutil.chars.CharList
add, add, contains, remove, replaceAll, spliteratorMethods inherited from interface java.util.Collection
toArrayMethods inherited from interface java.util.List
addAll, clear, containsAll, isEmpty, removeAll, retainAll, size, toArray, toArray
-
Method Details
-
getChar
public char getChar(int i)Description copied from interface:CharListReturns the element at the specified position in this list. -
set
public char set(int i, char k)Description copied from interface:CharListReplaces the element at the specified position in this list with the specified element (optional operation). -
add
public void add(int i, char k)Description copied from interface:CharListInserts the specified element at the specified position in this list (optional operation). -
removeChar
public char removeChar(int i)Description copied from interface:CharListRemoves the element at the specified position in this list (optional operation).- Specified by:
removeCharin interfaceCharList- See Also:
List.remove(int)
-
indexOf
public int indexOf(char k)Description copied from interface:CharListReturns the index of the first occurrence of the specified element in this list, or -1 if this list does not contain the element. -
lastIndexOf
public int lastIndexOf(char k)Description copied from interface:CharListReturns the index of the last occurrence of the specified element in this list, or -1 if this list does not contain the element.- Specified by:
lastIndexOfin interfaceCharList- See Also:
List.lastIndexOf(Object)
-
addAll
public boolean addAll(int index, java.util.Collection<? extends java.lang.Character> c)- Specified by:
addAllin interfacejava.util.List<java.lang.Character>
-
replaceAll
@Deprecated public void replaceAll(java.util.function.UnaryOperator<java.lang.Character> operator)Deprecated.Description copied from interface:CharList- Specified by:
replaceAllin interfaceCharList- Specified by:
replaceAllin interfacejava.util.List<java.lang.Character>
-
getElements
public void getElements(int from, char[] a, int offset, int length)Description copied from interface:CharListCopies (hopefully quickly) elements of this type-specific list into the given array.- Specified by:
getElementsin interfaceCharList- Parameters:
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.
-
removeElements
public void removeElements(int from, int to)Description copied from interface:CharListRemoves (hopefully quickly) elements of this type-specific list.- Specified by:
removeElementsin interfaceCharList- Parameters:
from- the start index (inclusive).to- the end index (exclusive).
-
addElements
public void addElements(int index, char[] a, int offset, int length)Description copied from interface:CharListAdd (hopefully quickly) elements to this type-specific list.- Specified by:
addElementsin interfaceCharList- Parameters:
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.
-
addElements
public void addElements(int index, char[] a)Description copied from interface:CharListAdd (hopefully quickly) elements to this type-specific list.- Specified by:
addElementsin interfaceCharList- Parameters:
index- the index at which to add elements.a- the array containing the elements.
-
setElements
public void setElements(char[] a)Description copied from interface:CharListSet (hopefully quickly) elements to match the array given.- Specified by:
setElementsin interfaceCharList- Parameters:
a- the array containing the elements.
-
setElements
public void setElements(int index, char[] a)Description copied from interface:CharListSet (hopefully quickly) elements to match the array given.- Specified by:
setElementsin interfaceCharList- Parameters:
index- the index at which to start setting elements.a- the array containing the elements.
-
setElements
public void setElements(int index, char[] a, int offset, int length)Description copied from interface:CharListSet (hopefully quickly) elements to match the array given. Sets each in this list to the corresponding elements in the array, as if by
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.ListIterator iter = listIterator(index); int i = 0; while (i < length) { iter.next(); iter.set(a[offset + i++]); }- Specified by:
setElementsin interfaceCharList- Parameters:
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.
-
size
public void size(int size)Description copied from interface:CharListSets the size of this list.If the specified size is smaller than the current size, the last elements are discarded. Otherwise, they are filled with 0/
null/false. -
listIterator
Description copied from interface:CharListReturns a type-specific list iterator on the list.- Specified by:
listIteratorin interfaceCharList- Specified by:
listIteratorin interfacejava.util.List<java.lang.Character>- See Also:
List.listIterator()
-
iterator
Description copied from interface:CharCollectionReturns a type-specific iterator on the elements of this collection.- Specified by:
iteratorin interfaceCharCollection- Specified by:
iteratorin interfaceCharIterable- Specified by:
iteratorin interfaceCharList- Specified by:
iteratorin interfacejava.util.Collection<java.lang.Character>- Specified by:
iteratorin interfacejava.lang.Iterable<java.lang.Character>- Specified by:
iteratorin interfacejava.util.List<java.lang.Character>- Returns:
- a type-specific iterator on the elements of this collection.
- See Also:
Iterable.iterator()
-
listIterator
Description copied from interface:CharListReturns a type-specific list iterator on the list starting at a given index.- Specified by:
listIteratorin interfaceCharList- Specified by:
listIteratorin interfacejava.util.List<java.lang.Character>- See Also:
List.listIterator(int)
-
subList
Description copied from interface:CharListReturns a type-specific view of the portion of this list from the indexfrom, inclusive, to the indexto, exclusive. -
equals
public boolean equals(java.lang.Object o)- Specified by:
equalsin interfacejava.util.Collection<java.lang.Character>- Specified by:
equalsin interfacejava.util.List<java.lang.Character>
-
hashCode
public int hashCode()- Specified by:
hashCodein interfacejava.util.Collection<java.lang.Character>- Specified by:
hashCodein interfacejava.util.List<java.lang.Character>
-
compareTo
public int compareTo(java.util.List<? extends java.lang.Character> o)- Specified by:
compareToin interfacejava.lang.Comparable<java.util.List<? extends java.lang.Character>>
-
addAll
Description copied from interface:CharListInserts all of the elements in the specified type-specific collection into this type-specific list at the specified position (optional operation). -
addAll
Description copied from interface:CharListAppends all of the elements in the specified type-specific list to the end of this type-specific list (optional operation). -
addAll
Description copied from interface:CharListInserts all of the elements in the specified type-specific list into this type-specific list at the specified position (optional operation). -
replaceAll
public void replaceAll(java.util.function.IntUnaryOperator operator)Description copied from interface:CharListReplaces each element of this list with the result of applying the operator to that element, performing widening and narrowing primitive casts, until all elements have been processed or the action throws an exception.- Specified by:
replaceAllin interfaceCharList- Parameters:
operator- the operator to apply to each element- See Also:
List.replaceAll(java.util.function.UnaryOperator<E>)
-
get
@Deprecated public java.lang.Character get(int i)Deprecated.Please use the corresponding type-specific method instead. -
add
@Deprecated public void add(int i, java.lang.Character k)Deprecated.Please use the corresponding type-specific method instead. -
set
@Deprecated public java.lang.Character set(int index, java.lang.Character k)Deprecated.Please use the corresponding type-specific method instead. -
remove
@Deprecated public java.lang.Character remove(int i)Deprecated.Please use the corresponding type-specific method instead. -
indexOf
@Deprecated public int indexOf(java.lang.Object o)Deprecated.Please use the corresponding type-specific method instead. -
lastIndexOf
@Deprecated public int lastIndexOf(java.lang.Object o)Deprecated.Please use the corresponding type-specific method instead.- Specified by:
lastIndexOfin interfaceCharList- Specified by:
lastIndexOfin interfacejava.util.List<java.lang.Character>
-
sort
Description copied from interface:CharListSort a list using a type-specific comparator.Pass
nullto sort using natural ordering. -
unstableSort
Description copied from interface:CharListSorts this list using a sort not assured to be stable.Pass
nullto 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.
- Specified by:
unstableSortin interfaceCharList
-
sort
@Deprecated public void sort(java.util.Comparator<? super java.lang.Character> comparator)Deprecated.Description copied from interface:CharList -
unstableSort
@Deprecated public void unstableSort(java.util.Comparator<? super java.lang.Character> comparator)Deprecated.Description copied from interface:CharListSorts this list using a sort not assured to be stable.- Specified by:
unstableSortin interfaceCharList
-
add
public boolean add(char k)Description copied from interface:CharCollectionEnsures that this collection contains the specified element (optional operation).- Specified by:
addin interfaceCharCollection- See Also:
Collection.add(Object)
-
rem
public boolean rem(char k)Description copied from interface:CharCollectionRemoves a single instance of the specified element from this collection, if it is present (optional operation).Note that this method should be called
remove(), but the clash with the similarly named index-based method in theListinterface forces us to use a distinguished name. For simplicity, the set interfaces reinstatesremove().- Specified by:
remin interfaceCharCollection- See Also:
Collection.remove(Object)
-
size
public int size()- Specified by:
sizein interfacejava.util.Collection<java.lang.Character>
-
isEmpty
public boolean isEmpty()- Specified by:
isEmptyin interfacejava.util.Collection<java.lang.Character>
-
contains
public boolean contains(char o)Description copied from interface:CharCollectionReturnstrueif this collection contains the specified element.- Specified by:
containsin interfaceCharCollection- See Also:
Collection.contains(Object)
-
spliterator
Description copied from interface:CharCollectionReturns a type-specific spliterator on the elements of this collection.See
Collection.spliterator()for more documentation on the requirements of the returned spliterator.- Specified by:
spliteratorin interfaceCharCollection- Specified by:
spliteratorin interfaceCharIterable- Specified by:
spliteratorin interfacejava.util.Collection<java.lang.Character>- Specified by:
spliteratorin interfacejava.lang.Iterable<java.lang.Character>- Returns:
- a type-specific spliterator on the elements of this collection.
-
stream
@Deprecated public java.util.stream.Stream<java.lang.Character> stream()Deprecated.Description copied from interface:CharCollection- Specified by:
streamin interfaceCharCollection- Specified by:
streamin interfacejava.util.Collection<java.lang.Character>
-
parallelStream
@Deprecated public java.util.stream.Stream<java.lang.Character> parallelStream()Deprecated.Description copied from interface:CharCollection- Specified by:
parallelStreamin interfaceCharCollection- Specified by:
parallelStreamin interfacejava.util.Collection<java.lang.Character>
-
clear
public void clear()- Specified by:
clearin interfacejava.util.Collection<java.lang.Character>
-
toArray
public <T> T[] toArray(T[] a)- Specified by:
toArrayin interfacejava.util.Collection<java.lang.Character>
-
toArray
public java.lang.Object[] toArray()- Specified by:
toArrayin interfacejava.util.Collection<java.lang.Character>
-
forEach
Description copied from interface:CharIterablePerforms the given action for each element of this type-specificIterableuntil all elements have been processed or the action throws an exception.- Specified by:
forEachin interfaceCharIterable- Parameters:
action- the action to be performed for each element.- See Also:
Iterable.forEach(java.util.function.Consumer)
-
containsAll
public boolean containsAll(java.util.Collection<?> c)- Specified by:
containsAllin interfacejava.util.Collection<java.lang.Character>
-
addAll
public boolean addAll(java.util.Collection<? extends java.lang.Character> c)- Specified by:
addAllin interfacejava.util.Collection<java.lang.Character>
-
removeAll
public boolean removeAll(java.util.Collection<?> c)- Specified by:
removeAllin interfacejava.util.Collection<java.lang.Character>
-
retainAll
public boolean retainAll(java.util.Collection<?> c)- Specified by:
retainAllin interfacejava.util.Collection<java.lang.Character>
-
removeIf
Description copied from interface:CharCollectionRemove from this collection all elements which satisfy the given predicate.- Specified by:
removeIfin interfaceCharCollection- Parameters:
filter- a predicate which returnstruefor elements to be removed.- Returns:
trueif any elements were removed.- See Also:
Collection.removeIf(java.util.function.Predicate)
-
add
@Deprecated public boolean add(java.lang.Character k)Deprecated.Description copied from interface:CharCollection- Specified by:
addin interfaceCharCollection- Specified by:
addin interfacejava.util.Collection<java.lang.Character>
-
contains
@Deprecated public boolean contains(java.lang.Object k)Deprecated.Description copied from interface:CharCollection- Specified by:
containsin interfaceCharCollection- Specified by:
containsin interfacejava.util.Collection<java.lang.Character>
-
remove
@Deprecated public boolean remove(java.lang.Object k)Deprecated.Description copied from interface:CharCollection- Specified by:
removein interfaceCharCollection- Specified by:
removein interfacejava.util.Collection<java.lang.Character>
-
toCharArray
public char[] toCharArray()Description copied from interface:CharCollectionReturns a primitive type array containing the items of this collection.- Specified by:
toCharArrayin interfaceCharCollection- Returns:
- a primitive type array containing the items of this collection.
- See Also:
Collection.toArray()
-
toCharArray
@Deprecated public char[] toCharArray(char[] a)Deprecated.Description copied from interface:CharCollectionReturns a primitive type array containing the items of this collection.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.- Specified by:
toCharArrayin interfaceCharCollection- Parameters:
a- if this array is big enough, it will be used to store this collection.- Returns:
- a primitive type array containing the items of this collection.
- See Also:
Collection.toArray(Object[])
-
toArray
public char[] toArray(char[] a)Description copied from interface:CharCollectionReturns an array containing all of the elements in this collection; the runtime type of the returned array is that of the specified array.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.- Specified by:
toArrayin interfaceCharCollection- Parameters:
a- if this array is big enough, it will be used to store this collection.- Returns:
- a primitive type array containing the items of this collection.
- See Also:
Collection.toArray(Object[])
-
containsAll
Description copied from interface:CharCollectionChecks whether this collection contains all elements from the given type-specific collection.- Specified by:
containsAllin interfaceCharCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection contains all elements of the argument.- See Also:
Collection.containsAll(Collection)
-
addAll
Description copied from interface:CharCollectionAdds all elements of the given type-specific collection to this collection.- Specified by:
addAllin interfaceCharCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.addAll(Collection)
-
removeAll
Description copied from interface:CharCollectionRemove from this collection all elements in the given type-specific collection.- Specified by:
removeAllin interfaceCharCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.removeAll(Collection)
-
retainAll
Description copied from interface:CharCollectionRetains in this collection only elements from the given type-specific collection.- Specified by:
retainAllin interfaceCharCollection- Parameters:
c- a type-specific collection.- Returns:
trueif this collection changed as a result of the call.- See Also:
Collection.retainAll(Collection)
-
intIterator
Description copied from interface:CharCollectionReturns a widened primitive iterator on the elements of this collection.This method is provided for the purpose of APIs that expect only the JDK's primitive iterators, of which there are only
int,long, anddouble.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. SeeCharacterfor more discussion on code points, char values, and surrogate pairs.- Specified by:
intIteratorin interfaceCharCollection- Specified by:
intIteratorin interfaceCharIterable- Returns:
- a widened primitive iterator on the elements of this collection.
-
intSpliterator
Description copied from interface:CharCollectionReturns widened primitive spliterator on the elements of this collection.This method is provided for the purpose of APIs that expect only the JDK's primitive spliterators, of which there are only
int,long, anddouble.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. SeeCharacterfor more discussion on code points, char values, and surrogate pairs.- Specified by:
intSpliteratorin interfaceCharCollection- Specified by:
intSpliteratorin interfaceCharIterable- Returns:
- a widened primitive spliterator on the elements of this collection.
-
intStream
public java.util.stream.IntStream intStream()Description copied from interface:CharCollectionReturn a primitive stream over the elements, performing widening casts if needed.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. SeeCharacterfor more discussion on code points, char values, and surrogate pairs.- Specified by:
intStreamin interfaceCharCollection- Returns:
- a primitive stream over the elements.
- See Also:
Collection.stream(),IntStream
-
intParallelStream
public java.util.stream.IntStream intParallelStream()Description copied from interface:CharCollectionReturn a parallel primitive stream over the elements, performing widening casts if needed.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. SeeCharacterfor more discussion on code points, char values, and surrogate pairs.- Specified by:
intParallelStreamin interfaceCharCollection- Returns:
- a parallel primitive stream over the elements.
- See Also:
Collection.parallelStream(),IntStream
-
toString
public java.lang.String toString()- Overrides:
toStringin classjava.lang.Object
-