com.landawn.abacus.util

Class CharList

java.lang.Object

com.landawn.abacus.util.PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

com.landawn.abacus.util.CharList

All Implemented Interfaces:

java.io.Serializable, java.util.RandomAccess

public final class CharList
extends PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Since:

0.8

Author:

Haiyang Li

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CharList()
CharList(char[] a) The specified array is used as the element array for this list without copying action.
CharList(char[] a, int size)
CharList(int initialCapacity)

Method Summary

Modifier and Type	Method and Description
void	add(char e)
void	add(int index, char e)
boolean	addAll(char[] a)
boolean	addAll(CharList c)
boolean	addAll(int index, char[] a)
boolean	addAll(int index, CharList c)
boolean	allMatch(int fromIndex, int toIndex, CharPredicate filter)
boolean	anyMatch(int fromIndex, int toIndex, CharPredicate filter)
char[]	array() Returns the original element array without copying.
OptionalDouble	average()
OptionalDouble	average(int fromIndex, int toIndex)
int	binarySearch(char key) This List should be sorted first.
int	binarySearch(int fromIndex, int toIndex, char key) This List should be sorted first.
java.util.List<java.lang.Character>	boxed()
java.util.List<java.lang.Character>	boxed(int fromIndex, int toIndex)
void	clear()
boolean	contains(char e)
boolean	containsAll(char[] a)
boolean	containsAll(CharList c)
boolean	containsAny(char[] a)
boolean	containsAny(CharList c)
CharList	copy()
CharList	copy(int fromIndex, int toIndex)
CharList	copy(int from, int to, int step)
int	count(int fromIndex, int toIndex, CharPredicate filter)
char	delete(int index)
void	deleteAll(int... indices)
CharList	difference(char[] a)
CharList	difference(CharList b)
boolean	disjoint(char[] b)
boolean	disjoint(CharList c)
CharList	distinct(int fromIndex, int toIndex)
boolean	equals(java.lang.Object obj)
void	fill(char val)
void	fill(int fromIndex, int toIndex, char val)
CharList	filter(int fromIndex, int toIndex, CharPredicate filter)
CharList	filter(int fromIndex, int toIndex, CharPredicate filter, int max)
OptionalChar	findFirst(CharPredicate predicate)
OptionalInt	findFirstIndex(CharPredicate predicate)
OptionalChar	findLast(CharPredicate predicate)
OptionalInt	findLastIndex(CharPredicate predicate)
OptionalChar	first()
void	forEach(IndexedCharConsumer action)
void	forEach(int fromIndex, int toIndex, CharConsumer action)
void	forEach(int fromIndex, int toIndex, IndexedCharConsumer action)
static CharList	from(java.util.Collection<java.lang.Character> c)
static CharList	from(java.util.Collection<java.lang.Character> c, char defaultValueForNull)
char	get(int index)
boolean	hasDuplicates()
int	hashCode()
int	indexOf(char e)
int	indexOf(int fromIndex, char e)
CharList	intersection(char[] a)
CharList	intersection(CharList b)
boolean	isEmpty()
CharIterator	iterator()
java.lang.String	join(int fromIndex, int toIndex, char delimiter)
java.lang.String	join(int fromIndex, int toIndex, java.lang.String delimiter)
OptionalChar	kthLargest(int k)
OptionalChar	kthLargest(int fromIndex, int toIndex, int k)
OptionalChar	last()
int	lastIndexOf(char e)
int	lastIndexOf(int fromIndex, char e)
CharList	map(CharUnaryOperator mapper)
CharList	map(int fromIndex, int toIndex, CharUnaryOperator mapper)
<T> java.util.List<T>	mapToObj(CharFunction<? extends T> mapper)
<T> java.util.List<T>	mapToObj(int fromIndex, int toIndex, CharFunction<? extends T> mapper)
OptionalChar	max()
OptionalChar	max(int fromIndex, int toIndex)
OptionalChar	median()
OptionalChar	median(int fromIndex, int toIndex)
OptionalChar	min()
OptionalChar	min(int fromIndex, int toIndex)
boolean	noneMatch(int fromIndex, int toIndex, CharPredicate filter)
int	occurrencesOf(char objectToFind)
static CharList	of(char... a)
static CharList	of(char[] a, int size)
void	parallelSort()
static CharList	random(char[] candicates, int len)
static CharList	random(char startInclusive, char endExclusive, int len)
static CharList	random(int len)
static CharList	range(char startInclusive, char endExclusive)
static CharList	range(char startInclusive, char endExclusive, int by)
static CharList	rangeClosed(char startInclusive, char endInclusive)
static CharList	rangeClosed(char startInclusive, char endInclusive, int by)
OptionalChar	reduce(CharBinaryOperator accumulator) This is equivalent to:
char	reduce(char identity, CharBinaryOperator accumulator) This is equivalent to:
boolean	remove(char e)
boolean	removeAll(char[] a)
boolean	removeAll(CharList c)
boolean	removeAllOccurrences(char e)
boolean	removeIf(CharPredicate p)
static CharList	repeat(char element, int len)
int	replaceAll(char oldVal, char newVal)
void	replaceAll(CharUnaryOperator operator)
boolean	replaceIf(CharPredicate predicate, char newValue)
boolean	retainAll(char[] a)
boolean	retainAll(CharList c)
void	reverse()
void	reverse(int fromIndex, int toIndex)
void	reverseSort()
void	rotate(int distance)
char	set(int index, char e)
void	shuffle()
void	shuffle(java.util.Random rnd)
int	size()
void	sort()
java.util.List<CharList>	split(int fromIndex, int toIndex, int size)
CharStream	stream()
CharStream	stream(int fromIndex, int toIndex)
int	sum()
int	sum(int fromIndex, int toIndex)
void	swap(int i, int j)
CharList	symmetricDifference(char[] a)
CharList	symmetricDifference(CharList b)
IntList	toIntList()
<R extends java.util.List<java.lang.Character>> R	toList(int fromIndex, int toIndex, IntFunction<R> supplier)
<K,U> java.util.Map<K,U>	toMap(CharFunction<? extends K> keyExtractor, CharFunction<? extends U> valueMapper)
<K,U> java.util.Map<K,U>	toMap(CharFunction<? extends K> keyExtractor, CharFunction<? extends U> valueMapper, BinaryOperator<U> mergeFunction)
<K,U,M extends java.util.Map<K,U>> M	toMap(CharFunction<? extends K> keyExtractor, CharFunction<? extends U> valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapFactory)
<K,U,M extends java.util.Map<K,U>> M	toMap(CharFunction<? extends K> keyExtractor, CharFunction<? extends U> valueMapper, Supplier<M> mapFactory)
<K,A,D> java.util.Map<K,D>	toMap(CharFunction<? extends K> classifier, Collector<java.lang.Character,A,D> downstream)
<K,A,D,M extends java.util.Map<K,D>> M	toMap(CharFunction<? extends K> classifier, Collector<java.lang.Character,A,D> downstream, Supplier<M> mapFactory)
Multiset<java.lang.Character>	toMultiset(int fromIndex, int toIndex, IntFunction<Multiset<java.lang.Character>> supplier)
<R extends java.util.Set<java.lang.Character>> R	toSet(int fromIndex, int toIndex, IntFunction<R> supplier)
java.lang.String	toString()
CharList	trimToSize()

Methods inherited from class com.landawn.abacus.util.PrimitiveList

allMatch, anyMatch, count, distinct, filter, filter, forEach, join, join, join, join, noneMatch, println, split, toList, toList, toList, toMultiset, toMultiset, toMultiset, toSet, toSet, toSet

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CharList

public CharList()

CharList

public CharList(int initialCapacity)

CharList

public CharList(char[] a)

The specified array is used as the element array for this list without copying action.

Parameters:

a -

CharList

public CharList(char[] a,
                int size)

Method Detail

of

@SafeVarargs
public static CharList of(char... a)

of

public static CharList of(char[] a,
                          int size)

from

public static CharList from(java.util.Collection<java.lang.Character> c)

from

public static CharList from(java.util.Collection<java.lang.Character> c,
                            char defaultValueForNull)

range

public static CharList range(char startInclusive,
                             char endExclusive)

range

public static CharList range(char startInclusive,
                             char endExclusive,
                             int by)

rangeClosed

public static CharList rangeClosed(char startInclusive,
                                   char endInclusive)

rangeClosed

public static CharList rangeClosed(char startInclusive,
                                   char endInclusive,
                                   int by)

repeat

public static CharList repeat(char element,
                              int len)

random

public static CharList random(int len)

random

public static CharList random(char startInclusive,
                              char endExclusive,
                              int len)

random

public static CharList random(char[] candicates,
                              int len)

array

public char[] array()

Returns the original element array without copying.

Returns:

get

public char get(int index)

set

public char set(int index,
                char e)

Parameters:

index -

e -

Returns:

the old value in the specified position.

add

public void add(char e)

add

public void add(int index,
                char e)

addAll

public boolean addAll(CharList c)

addAll

public boolean addAll(int index,
                      CharList c)

addAll

public boolean addAll(char[] a)

Specified by:

addAll in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

addAll

public boolean addAll(int index,
                      char[] a)

Specified by:

addAll in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

remove

public boolean remove(char e)

Parameters:

e -

Returns:

true if this list contained the specified element

removeAllOccurrences

public boolean removeAllOccurrences(char e)

Parameters:

e -

Returns:

true if this list contained the specified element

removeAll

public boolean removeAll(CharList c)

removeAll

public boolean removeAll(char[] a)

Specified by:

removeAll in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

removeIf

public boolean removeIf(CharPredicate p)

Specified by:

removeIf in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

retainAll

public boolean retainAll(CharList c)

retainAll

public boolean retainAll(char[] a)

delete

public char delete(int index)

Parameters:

index -

Returns:

the deleted element

deleteAll

public void deleteAll(int... indices)

Specified by:

deleteAll in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

replaceAll

public int replaceAll(char oldVal,
                      char newVal)

replaceAll

public void replaceAll(CharUnaryOperator operator)

replaceIf

public boolean replaceIf(CharPredicate predicate,
                         char newValue)

fill

public void fill(char val)

fill

public void fill(int fromIndex,
                 int toIndex,
                 char val)

contains

public boolean contains(char e)

containsAll

public boolean containsAll(CharList c)

containsAll

public boolean containsAll(char[] a)

Specified by:

containsAll in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

containsAny

public boolean containsAny(CharList c)

containsAny

public boolean containsAny(char[] a)

Specified by:

containsAny in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

disjoint

public boolean disjoint(CharList c)

disjoint

public boolean disjoint(char[] b)

Specified by:

disjoint in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

intersection

public CharList intersection(CharList b)

Parameters:

b -

Returns:

See Also:

IntList.intersection(IntList)

intersection

public CharList intersection(char[] a)

difference

public CharList difference(CharList b)

Parameters:

b -

Returns:

See Also:

IntList.difference(IntList)

difference

public CharList difference(char[] a)

symmetricDifference

public CharList symmetricDifference(CharList b)

Parameters:

b -

Returns:

this.difference(b).addAll(b.difference(this))

See Also:

IntList.symmetricDifference(IntList)

symmetricDifference

public CharList symmetricDifference(char[] a)

occurrencesOf

public int occurrencesOf(char objectToFind)

indexOf

public int indexOf(char e)

indexOf

public int indexOf(int fromIndex,
                   char e)

lastIndexOf

public int lastIndexOf(char e)

lastIndexOf

public int lastIndexOf(int fromIndex,
                       char e)

Parameters:

fromIndex - the start index to traverse backwards from. Inclusive.

e -

Returns:

min

public OptionalChar min()

min

public OptionalChar min(int fromIndex,
                        int toIndex)

median

public OptionalChar median()

median

public OptionalChar median(int fromIndex,
                           int toIndex)

max

public OptionalChar max()

max

public OptionalChar max(int fromIndex,
                        int toIndex)

kthLargest

public OptionalChar kthLargest(int k)

kthLargest

public OptionalChar kthLargest(int fromIndex,
                               int toIndex,
                               int k)

sum

public int sum()

sum

public int sum(int fromIndex,
               int toIndex)

average

public OptionalDouble average()

average

public OptionalDouble average(int fromIndex,
                              int toIndex)

forEach

public void forEach(int fromIndex,
                    int toIndex,
                    CharConsumer action)

Specified by:

forEach in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

forEach

public void forEach(IndexedCharConsumer action)

forEach

public void forEach(int fromIndex,
                    int toIndex,
                    IndexedCharConsumer action)

first

public OptionalChar first()

last

public OptionalChar last()

findFirst

public OptionalChar findFirst(CharPredicate predicate)

findLast

public OptionalChar findLast(CharPredicate predicate)

findFirstIndex

public OptionalInt findFirstIndex(CharPredicate predicate)

findLastIndex

public OptionalInt findLastIndex(CharPredicate predicate)

allMatch

public boolean allMatch(int fromIndex,
                        int toIndex,
                        CharPredicate filter)

Specified by:

allMatch in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

anyMatch

public boolean anyMatch(int fromIndex,
                        int toIndex,
                        CharPredicate filter)

Specified by:

anyMatch in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

noneMatch

public boolean noneMatch(int fromIndex,
                         int toIndex,
                         CharPredicate filter)

Specified by:

noneMatch in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

hasDuplicates

public boolean hasDuplicates()

Specified by:

hasDuplicates in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

count

public int count(int fromIndex,
                 int toIndex,
                 CharPredicate filter)

Specified by:

count in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

filter

public CharList filter(int fromIndex,
                       int toIndex,
                       CharPredicate filter)

Specified by:

filter in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

filter

public CharList filter(int fromIndex,
                       int toIndex,
                       CharPredicate filter,
                       int max)

Specified by:

filter in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

map

public CharList map(CharUnaryOperator mapper)

map

public CharList map(int fromIndex,
                    int toIndex,
                    CharUnaryOperator mapper)

mapToObj

public <T> java.util.List<T> mapToObj(CharFunction<? extends T> mapper)

mapToObj

public <T> java.util.List<T> mapToObj(int fromIndex,
                                      int toIndex,
                                      CharFunction<? extends T> mapper)

reduce

public OptionalChar reduce(CharBinaryOperator accumulator)

This is equivalent to:

 
    if (isEmpty()) {
        return OptionalChar.empty();
    }

    char result = elementData[0];

    for (int i = 1; i < size; i++) {
        result = accumulator.applyAsChar(result, elementData[i]);
    }

    return OptionalChar.of(result);
 
 

Parameters:

accumulator -

Returns:

reduce

public char reduce(char identity,
                   CharBinaryOperator accumulator)

This is equivalent to:

 
     if (isEmpty()) {
         return identity;
     }
 
     char result = identity;
 
     for (int i = 0; i < size; i++) {
         result = accumulator.applyAsChar(result, elementData[i]);
    }
 
     return result;
 
 

Parameters:

identity -

accumulator -

Returns:

distinct

public CharList distinct(int fromIndex,
                         int toIndex)

Specified by:

distinct in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

sort

public void sort()

Specified by:

sort in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

parallelSort

public void parallelSort()

reverseSort

public void reverseSort()

binarySearch

public int binarySearch(char key)

This List should be sorted first.

Parameters:

key -

Returns:

binarySearch

public int binarySearch(int fromIndex,
                        int toIndex,
                        char key)

This List should be sorted first.

Parameters:

fromIndex -

toIndex -

key -

Returns:

reverse

public void reverse()

Specified by:

reverse in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

reverse

public void reverse(int fromIndex,
                    int toIndex)

Specified by:

reverse in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

rotate

public void rotate(int distance)

Specified by:

rotate in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

shuffle

public void shuffle()

Specified by:

shuffle in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

shuffle

public void shuffle(java.util.Random rnd)

Specified by:

shuffle in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

swap

public void swap(int i,
                 int j)

Specified by:

swap in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

copy

public CharList copy()

Specified by:

copy in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

a copy of this List

copy

public CharList copy(int fromIndex,
                     int toIndex)

Specified by:

copy in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

copy

public CharList copy(int from,
                     int to,
                     int step)

Specified by:

copy in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Parameters:

from -

to -

step -

Returns:

See Also:

N.copyOfRange(int[], int, int, int)

split

public java.util.List<CharList> split(int fromIndex,
                                      int toIndex,
                                      int size)

Specified by:

split in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

join

public java.lang.String join(int fromIndex,
                             int toIndex,
                             char delimiter)

Specified by:

join in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

join

public java.lang.String join(int fromIndex,
                             int toIndex,
                             java.lang.String delimiter)

Specified by:

join in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

trimToSize

public CharList trimToSize()

Specified by:

trimToSize in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

Returns:

this List with trailing unused space removed.

clear

public void clear()

Specified by:

clear in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

size

public int size()

Specified by:

size in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

boxed

public java.util.List<java.lang.Character> boxed()

boxed

public java.util.List<java.lang.Character> boxed(int fromIndex,
                                                 int toIndex)

toIntList

public IntList toIntList()

toList

public <R extends java.util.List<java.lang.Character>> R toList(int fromIndex,
                                                                int toIndex,
                                                                IntFunction<R> supplier)

Specified by:

toList in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

toSet

public <R extends java.util.Set<java.lang.Character>> R toSet(int fromIndex,
                                                              int toIndex,
                                                              IntFunction<R> supplier)

Specified by:

toSet in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

toMultiset

public Multiset<java.lang.Character> toMultiset(int fromIndex,
                                                int toIndex,
                                                IntFunction<Multiset<java.lang.Character>> supplier)

Specified by:

toMultiset in class PrimitiveList<CharConsumer,CharPredicate,java.lang.Character,char[],CharList>

toMap

public <K,U> java.util.Map<K,U> toMap(CharFunction<? extends K> keyExtractor,
                                      CharFunction<? extends U> valueMapper)

toMap

public <K,U,M extends java.util.Map<K,U>> M toMap(CharFunction<? extends K> keyExtractor,
                                                  CharFunction<? extends U> valueMapper,
                                                  Supplier<M> mapFactory)

toMap

public <K,U> java.util.Map<K,U> toMap(CharFunction<? extends K> keyExtractor,
                                      CharFunction<? extends U> valueMapper,
                                      BinaryOperator<U> mergeFunction)

toMap

public <K,U,M extends java.util.Map<K,U>> M toMap(CharFunction<? extends K> keyExtractor,
                                                  CharFunction<? extends U> valueMapper,
                                                  BinaryOperator<U> mergeFunction,
                                                  Supplier<M> mapFactory)

toMap

public <K,A,D> java.util.Map<K,D> toMap(CharFunction<? extends K> classifier,
                                        Collector<java.lang.Character,A,D> downstream)

toMap

public <K,A,D,M extends java.util.Map<K,D>> M toMap(CharFunction<? extends K> classifier,
                                                    Collector<java.lang.Character,A,D> downstream,
                                                    Supplier<M> mapFactory)

iterator

public CharIterator iterator()

stream

public CharStream stream()

stream

public CharStream stream(int fromIndex,
                         int toIndex)

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object