com.landawn.abacus.util.CharList Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of abacus-common Show documentation
Show all versions of abacus-common Show documentation
A general programming library in Java/Android. It's easy to learn and simple to use with concise and powerful APIs.
/*
* Copyright (c) 2015, Haiyang Li.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.landawn.abacus.util;
import java.security.SecureRandom;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.List;
import java.util.Random;
import java.util.Set;
import java.util.function.IntFunction;
import com.landawn.abacus.annotation.Beta;
import com.landawn.abacus.annotation.SuppressFBWarnings;
import com.landawn.abacus.util.If.OrElse;
import com.landawn.abacus.util.u.Optional;
import com.landawn.abacus.util.u.OptionalChar;
import com.landawn.abacus.util.u.OptionalDouble;
import com.landawn.abacus.util.u.OptionalInt;
import com.landawn.abacus.util.stream.CharStream;
/**
*
* @author Haiyang Li
* @since 0.8
*
* @see com.landawn.abacus.util.N
* @see com.landawn.abacus.util.Array
* @see com.landawn.abacus.util.Iterables
* @see com.landawn.abacus.util.Iterators
*/
public final class CharList extends PrimitiveList {
private static final long serialVersionUID = 7293826835233022514L;
static final Random RAND = new SecureRandom();
private char[] elementData = N.EMPTY_CHAR_ARRAY;
private int size = 0;
/**
*
*/
public CharList() {
}
/**
*
*
* @param initialCapacity
*/
public CharList(int initialCapacity) {
elementData = initialCapacity == 0 ? N.EMPTY_CHAR_ARRAY : new char[initialCapacity];
}
/**
* The specified array is used as the element array for this list without copying action.
*
* @param a
*/
public CharList(char[] a) {
this(a, a.length);
}
/**
*
*
* @param a
* @param size
*/
public CharList(char[] a, int size) {
N.checkFromIndexSize(0, size, a.length);
this.elementData = a;
this.size = size;
}
/**
*
* @param a
* @return
*/
@SafeVarargs
public static CharList of(final char... a) {
return new CharList(N.nullToEmpty(a));
}
/**
*
* @param a
* @param size
* @return
*/
public static CharList of(final char[] a, final int size) {
N.checkFromIndexSize(0, size, N.len(a));
return new CharList(N.nullToEmpty(a), size);
}
/**
*
* @param a
* @return
*/
public static CharList copyOf(final char[] a) {
return of(N.clone(a));
}
/**
*
* @param a
* @param fromIndex
* @param toIndex
* @return
*/
public static CharList copyOf(final char[] a, final int fromIndex, final int toIndex) {
return of(N.copyOfRange(a, fromIndex, toIndex));
}
/**
*
* @param c
* @return
*/
public static CharList from(Collection c) {
if (N.isNullOrEmpty(c)) {
return new CharList();
}
return from(c, (char) 0);
}
/**
*
* @param c
* @param defaultForNull
* @return
*/
public static CharList from(Collection c, char defaultForNull) {
if (N.isNullOrEmpty(c)) {
return new CharList();
}
final char[] a = new char[c.size()];
int idx = 0;
for (Character e : c) {
a[idx++] = e == null ? defaultForNull : e;
}
return of(a);
}
/**
*
* @param c
* @param fromIndex
* @param toIndex
* @return
*/
public static CharList from(final Collection c, final int fromIndex, final int toIndex) {
N.checkFromToIndex(fromIndex, toIndex, N.size(c));
if (N.isNullOrEmpty(c)) {
return new CharList();
}
return from(c, fromIndex, toIndex, (char) 0);
}
/**
*
* @param c
* @param fromIndex
* @param toIndex
* @param defaultForNull
* @return
*/
public static CharList from(final Collection c, final int fromIndex, final int toIndex, char defaultForNull) {
return of(N.toCharArray(c, fromIndex, toIndex, defaultForNull));
}
/**
*
* @param startInclusive
* @param endExclusive
* @return
*/
public static CharList range(char startInclusive, final char endExclusive) {
return of(Array.range(startInclusive, endExclusive));
}
/**
*
* @param startInclusive
* @param endExclusive
* @param by
* @return
*/
public static CharList range(char startInclusive, final char endExclusive, final int by) {
return of(Array.range(startInclusive, endExclusive, by));
}
/**
*
* @param startInclusive
* @param endInclusive
* @return
*/
public static CharList rangeClosed(char startInclusive, final char endInclusive) {
return of(Array.rangeClosed(startInclusive, endInclusive));
}
/**
*
* @param startInclusive
* @param endInclusive
* @param by
* @return
*/
public static CharList rangeClosed(char startInclusive, final char endInclusive, final int by) {
return of(Array.rangeClosed(startInclusive, endInclusive, by));
}
/**
*
* @param element
* @param len
* @return
*/
public static CharList repeat(char element, final int len) {
return of(Array.repeat(element, len));
}
/**
*
* @param len
* @return
*/
public static CharList random(final int len) {
final char[] a = new char[len];
final int mod = Character.MAX_VALUE + 1;
for (int i = 0; i < len; i++) {
a[i] = (char) RAND.nextInt(mod);
}
return of(a);
}
/**
*
* @param startInclusive
* @param endExclusive
* @param len
* @return
*/
public static CharList random(final char startInclusive, final char endExclusive, final int len) {
if (startInclusive >= endExclusive) {
throw new IllegalArgumentException("'startInclusive' must be less than 'endExclusive'");
}
final char[] a = new char[len];
final int mod = endExclusive - startInclusive;
for (int i = 0; i < len; i++) {
a[i] = (char) (RAND.nextInt(mod) + startInclusive);
}
return of(a);
}
/**
*
* @param candicates
* @param len
* @return
*/
public static CharList random(final char[] candicates, final int len) {
if (N.isNullOrEmpty(candicates) || candicates.length >= Integer.MAX_VALUE) {
throw new IllegalArgumentException();
} else if (candicates.length == 1) {
return repeat(candicates[0], len);
}
final int n = candicates.length;
final char[] a = new char[len];
for (int i = 0; i < len; i++) {
a[i] = candicates[RAND.nextInt(n)];
}
return of(a);
}
/**
* Returns the original element array without copying.
*
* @return
*/
@Beta
@Override
public char[] array() {
return elementData;
}
/**
*
* @param index
* @return
*/
public char get(int index) {
rangeCheck(index);
return elementData[index];
}
/**
*
* @param index
*/
private void rangeCheck(int index) {
if (index >= size) {
throw new IndexOutOfBoundsException("Index: " + index + ", Size: " + size);
}
}
/**
*
* @param index
* @param e
* @return
*/
public char set(int index, char e) {
rangeCheck(index);
char oldValue = elementData[index];
elementData[index] = e;
return oldValue;
}
/**
*
* @param e
*/
public void add(char e) {
ensureCapacity(size + 1);
elementData[size++] = e;
}
/**
*
* @param index
* @param e
*/
public void add(int index, char e) {
rangeCheckForAdd(index);
ensureCapacity(size + 1);
int numMoved = size - index;
if (numMoved > 0) {
N.copy(elementData, index, elementData, index + 1, numMoved);
}
elementData[index] = e;
size++;
}
/**
* Adds the all.
*
* @param c
* @return
*/
@Override
public boolean addAll(CharList c) {
if (N.isNullOrEmpty(c)) {
return false;
}
int numNew = c.size();
ensureCapacity(size + numNew);
N.copy(c.array(), 0, elementData, size, numNew);
size += numNew;
return true;
}
/**
* Adds the all.
*
* @param index
* @param c
* @return
*/
@Override
public boolean addAll(int index, CharList c) {
rangeCheckForAdd(index);
if (N.isNullOrEmpty(c)) {
return false;
}
int numNew = c.size();
ensureCapacity(size + numNew); // Increments modCount
int numMoved = size - index;
if (numMoved > 0) {
N.copy(elementData, index, elementData, index + numNew, numMoved);
}
N.copy(c.array(), 0, elementData, index, numNew);
size += numNew;
return true;
}
/**
* Adds the all.
*
* @param a
* @return
*/
@Override
public boolean addAll(char[] a) {
return addAll(size(), a);
}
/**
* Adds the all.
*
* @param index
* @param a
* @return
*/
@Override
public boolean addAll(int index, char[] a) {
rangeCheckForAdd(index);
if (N.isNullOrEmpty(a)) {
return false;
}
int numNew = a.length;
ensureCapacity(size + numNew); // Increments modCount
int numMoved = size - index;
if (numMoved > 0) {
N.copy(elementData, index, elementData, index + numNew, numMoved);
}
N.copy(a, 0, elementData, index, numNew);
size += numNew;
return true;
}
/**
* Range check for add.
*
* @param index
*/
private void rangeCheckForAdd(int index) {
if (index > size || index < 0) {
throw new IndexOutOfBoundsException("Index: " + index + ", Size: " + size);
}
}
/**
*
* @param e
* @return true if this list contained the specified element
*/
public boolean remove(char e) {
for (int i = 0; i < size; i++) {
if (elementData[i] == e) {
fastRemove(i);
return true;
}
}
return false;
}
/**
* Removes the all occurrences.
*
* @param e
* @return true if this list contained the specified element
*/
public boolean removeAllOccurrences(char e) {
int w = 0;
for (int i = 0; i < size; i++) {
if (elementData[i] != e) {
elementData[w++] = elementData[i];
}
}
int numRemoved = size - w;
if (numRemoved > 0) {
N.fill(elementData, w, size, (char) 0);
size = w;
}
return numRemoved > 0;
}
/**
*
* @param index
*/
private void fastRemove(int index) {
int numMoved = size - index - 1;
if (numMoved > 0) {
N.copy(elementData, index + 1, elementData, index, numMoved);
}
elementData[--size] = 0; // clear to let GC do its work
}
/**
* Removes the all.
*
* @param c
* @return
*/
@Override
public boolean removeAll(CharList c) {
if (N.isNullOrEmpty(c)) {
return false;
}
return batchRemove(c, false) > 0;
}
/**
* Removes the all.
*
* @param a
* @return
*/
@Override
public boolean removeAll(char[] a) {
if (N.isNullOrEmpty(a)) {
return false;
}
return removeAll(of(a));
}
/**
* Removes the if.
*
* @param
* @param p
* @return
* @throws E the e
*/
public boolean removeIf(Throwables.CharPredicate p) throws E {
final CharList tmp = new CharList(size());
for (int i = 0; i < size; i++) {
if (!p.test(elementData[i])) {
tmp.add(elementData[i]);
}
}
if (tmp.size() == this.size()) {
return false;
}
N.copy(tmp.elementData, 0, this.elementData, 0, tmp.size());
N.fill(this.elementData, tmp.size(), size, (char) 0);
size = tmp.size;
return true;
}
/**
*
*
* @return
*/
@Override
public boolean removeDuplicates() {
if (size < 2) {
return false;
}
final boolean isSorted = isSorted();
int idx = 0;
if (isSorted) {
for (int i = 1; i < size; i++) {
if (elementData[i] != elementData[idx]) {
elementData[++idx] = elementData[i];
}
}
} else {
final Set set = N.newLinkedHashSet(size);
set.add(elementData[0]);
for (int i = 1; i < size; i++) {
if (set.add(elementData[i])) {
elementData[++idx] = elementData[i];
}
}
}
if (idx == size - 1) {
return false;
} else {
N.fill(elementData, idx + 1, size, (char) 0);
size = idx + 1;
return true;
}
}
/**
*
* @param c
* @return
*/
@Override
public boolean retainAll(CharList c) {
if (N.isNullOrEmpty(c)) {
boolean result = size() > 0;
clear();
return result;
}
return batchRemove(c, true) > 0;
}
/**
*
* @param a
* @return
*/
@Override
public boolean retainAll(char[] a) {
if (N.isNullOrEmpty(a)) {
boolean result = size() > 0;
clear();
return result;
}
return retainAll(CharList.of(a));
}
/**
*
* @param c
* @param complement
* @return
*/
private int batchRemove(CharList c, boolean complement) {
final char[] elementData = this.elementData;//NOSONAR
int w = 0;
if (c.size() > 3 && size() > 9) {
final Set set = c.toSet();
for (int i = 0; i < size; i++) {
if (set.contains(elementData[i]) == complement) {
elementData[w++] = elementData[i];
}
}
} else {
for (int i = 0; i < size; i++) {
if (c.contains(elementData[i]) == complement) {
elementData[w++] = elementData[i];
}
}
}
int numRemoved = size - w;
if (numRemoved > 0) {
N.fill(elementData, w, size, (char) 0);
size = w;
}
return numRemoved;
}
/**
*
* @param index
* @return
*/
public char delete(int index) {
rangeCheck(index);
char oldValue = elementData[index];
fastRemove(index);
return oldValue;
}
/**
*
* @param indices
*/
@Override
@SafeVarargs
public final void deleteAll(int... indices) {
if (N.isNullOrEmpty(indices)) {
return;
}
final char[] tmp = N.deleteAll(elementData, indices);
N.copy(tmp, 0, elementData, 0, tmp.length);
N.fill(elementData, tmp.length, size, (char) 0);
size = tmp.length;
}
/**
*
* @param fromIndex
* @param toIndex
*/
@Override
public void deleteRange(final int fromIndex, final int toIndex) {
N.checkFromToIndex(fromIndex, toIndex, size());
if (fromIndex == toIndex) {
return;
}
final int size = size();//NOSONAR
final int newSize = size - (toIndex - fromIndex);
if (toIndex < size) {
System.arraycopy(elementData, toIndex, elementData, fromIndex, size - toIndex);
}
N.fill(elementData, newSize, size, (char) 0);
this.size = newSize;
}
/**
*
*
* @param fromIndex
* @param toIndex
* @param newPositionStartIndex
*/
@Override
public void moveRange(final int fromIndex, final int toIndex, final int newPositionStartIndex) {
N.moveRange(elementData, fromIndex, toIndex, newPositionStartIndex);
}
/**
*
*
* @param fromIndex
* @param toIndex
* @param replacement
*/
@Override
public void replaceRange(final int fromIndex, final int toIndex, final char[] replacement) {
N.checkFromToIndex(fromIndex, toIndex, size());
if (N.isNullOrEmpty(replacement)) {
deleteRange(fromIndex, toIndex);
return;
}
final int size = this.size;//NOSONAR
final int newSize = size - (toIndex - fromIndex) + replacement.length;
if (elementData.length < newSize) {
elementData = N.copyOf(elementData, newSize);
}
if (toIndex - fromIndex != replacement.length && toIndex != size) {
N.copy(elementData, toIndex, elementData, fromIndex + replacement.length, size - toIndex);
}
N.copy(replacement, 0, elementData, fromIndex, replacement.length);
if (newSize < size) {
N.fill(elementData, newSize, size, (char) 0);
}
this.size = newSize;
}
/**
*
* @param oldVal
* @param newVal
* @return
*/
public int replaceAll(char oldVal, char newVal) {
if (size() == 0) {
return 0;
}
int result = 0;
for (int i = 0, len = size(); i < len; i++) {
if (elementData[i] == oldVal) {
elementData[i] = newVal;
result++;
}
}
return result;
}
/**
*
* @param
* @param operator
* @throws E the e
*/
public void replaceAll(Throwables.CharUnaryOperator operator) throws E {
for (int i = 0, len = size(); i < len; i++) {
elementData[i] = operator.applyAsChar(elementData[i]);
}
}
/**
*
* @param
* @param predicate
* @param newValue
* @return
* @throws E the e
*/
public boolean replaceIf(Throwables.CharPredicate predicate, char newValue) throws E {
boolean result = false;
for (int i = 0, len = size(); i < len; i++) {
if (predicate.test(elementData[i])) {
elementData[i] = newValue;
result = true;
}
}
return result;
}
/**
*
* @param val
*/
public void fill(final char val) {
fill(0, size(), val);
}
/**
*
* @param fromIndex
* @param toIndex
* @param val
*/
public void fill(final int fromIndex, final int toIndex, final char val) {
checkFromToIndex(fromIndex, toIndex);
N.fill(elementData, fromIndex, toIndex, val);
}
/**
*
* @param e
* @return
*/
public boolean contains(char e) {
return indexOf(e) >= 0;
}
/**
*
* @param c
* @return
*/
@Override
public boolean containsAny(CharList c) {
if (this.isEmpty() || N.isNullOrEmpty(c)) {
return false;
}
return !disjoint(c);
}
/**
*
* @param a
* @return
*/
@Override
public boolean containsAny(char[] a) {
if (this.isEmpty() || N.isNullOrEmpty(a)) {
return false;
}
return !disjoint(a);
}
/**
*
* @param c
* @return
*/
@Override
public boolean containsAll(CharList c) {
if (N.isNullOrEmpty(c)) {
return true;
} else if (isEmpty()) {
return false;
}
final boolean isThisContainer = size() >= c.size();
final CharList container = isThisContainer ? this : c;
final char[] iterElements = isThisContainer ? c.array() : this.array();
if (needToSet(size(), c.size())) {
final Set set = container.toSet();
for (int i = 0, iterLen = isThisContainer ? c.size() : this.size(); i < iterLen; i++) {
if (!set.contains(iterElements[i])) {
return false;
}
}
} else {
for (int i = 0, iterLen = isThisContainer ? c.size() : this.size(); i < iterLen; i++) {
if (!container.contains(iterElements[i])) {
return false;
}
}
}
return true;
}
/**
*
* @param a
* @return
*/
@Override
public boolean containsAll(char[] a) {
if (N.isNullOrEmpty(a)) {
return true;
} else if (isEmpty()) {
return false;
}
return containsAll(of(a));
}
/**
*
* @param c
* @return
*/
@Override
public boolean disjoint(final CharList c) {
if (isEmpty() || N.isNullOrEmpty(c)) {
return true;
}
final boolean isThisContainer = size() >= c.size();
final CharList container = isThisContainer ? this : c;
final char[] iterElements = isThisContainer ? c.array() : this.array();
if (needToSet(size(), c.size())) {
final Set set = container.toSet();
for (int i = 0, iterLen = isThisContainer ? c.size() : this.size(); i < iterLen; i++) {
if (set.contains(iterElements[i])) {
return false;
}
}
} else {
for (int i = 0, iterLen = isThisContainer ? c.size() : this.size(); i < iterLen; i++) {
if (container.contains(iterElements[i])) {
return false;
}
}
}
return true;
}
/**
*
* @param b
* @return
*/
@Override
public boolean disjoint(final char[] b) {
if (isEmpty() || N.isNullOrEmpty(b)) {
return true;
}
return disjoint(of(b));
}
/**
*
* @param b
* @return
* @see IntList#intersection(IntList)
*/
@Override
public CharList intersection(final CharList b) {
if (N.isNullOrEmpty(b)) {
return new CharList();
}
final Multiset bOccurrences = b.toMultiset();
final CharList c = new CharList(N.min(9, size(), b.size()));
for (int i = 0, len = size(); i < len; i++) {
if (bOccurrences.getAndRemove(elementData[i]) > 0) {
c.add(elementData[i]);
}
}
return c;
}
/**
*
* @param a
* @return
*/
@Override
public CharList intersection(final char[] a) {
if (N.isNullOrEmpty(a)) {
return new CharList();
}
return intersection(of(a));
}
/**
*
* @param b
* @return
* @see IntList#difference(IntList)
*/
@Override
public CharList difference(CharList b) {
if (N.isNullOrEmpty(b)) {
return of(N.copyOfRange(elementData, 0, size()));
}
final Multiset bOccurrences = b.toMultiset();
final CharList c = new CharList(N.min(size(), N.max(9, size() - b.size())));
for (int i = 0, len = size(); i < len; i++) {
if (bOccurrences.getAndRemove(elementData[i]) < 1) {
c.add(elementData[i]);
}
}
return c;
}
/**
*
* @param a
* @return
*/
@Override
public CharList difference(final char[] a) {
if (N.isNullOrEmpty(a)) {
return of(N.copyOfRange(elementData, 0, size()));
}
return difference(of(a));
}
/**
*
* @param b
* @return this.difference(b).addAll(b.difference(this))
* @see IntList#symmetricDifference(IntList)
*/
@Override
public CharList symmetricDifference(CharList b) {
if (N.isNullOrEmpty(b)) {
return this.copy();
} else if (this.isEmpty()) {
return b.copy();
}
final Multiset bOccurrences = b.toMultiset();
final CharList c = new CharList(N.max(9, Math.abs(size() - b.size())));
for (int i = 0, len = size(); i < len; i++) {
if (bOccurrences.getAndRemove(elementData[i]) < 1) {
c.add(elementData[i]);
}
}
for (int i = 0, len = b.size(); i < len; i++) {
if (bOccurrences.getAndRemove(b.elementData[i]) > 0) {
c.add(b.elementData[i]);
}
if (bOccurrences.isEmpty()) {
break;
}
}
return c;
}
/**
*
* @param a
* @return
*/
@Override
public CharList symmetricDifference(final char[] a) {
if (N.isNullOrEmpty(a)) {
return of(N.copyOfRange(elementData, 0, size()));
} else if (this.isEmpty()) {
return of(N.copyOfRange(a, 0, a.length));
}
return symmetricDifference(of(a));
}
/**
*
* @param objectToFind
* @return
*/
public int occurrencesOf(final char objectToFind) {
return N.occurrencesOf(elementData, objectToFind);
}
/**
*
* @param e
* @return
*/
public int indexOf(char e) {
return indexOf(0, e);
}
/**
*
* @param fromIndex
* @param e
* @return
*/
public int indexOf(final int fromIndex, char e) {
if (fromIndex >= size) {
return N.INDEX_NOT_FOUND;
}
for (int i = N.max(fromIndex, 0); i < size; i++) {
if (elementData[i] == e) {
return i;
}
}
return N.INDEX_NOT_FOUND;
}
/**
* Last index of.
*
* @param e
* @return
*/
public int lastIndexOf(char e) {
return lastIndexOf(size, e);
}
/**
* Last index of.
*
* @param fromIndex the start index to traverse backwards from. Inclusive.
* @param e
* @return
*/
public int lastIndexOf(final int fromIndex, char e) {
if (fromIndex < 0 || size == 0) {
return N.INDEX_NOT_FOUND;
}
for (int i = N.min(fromIndex, size - 1); i >= 0; i--) {
if (elementData[i] == e) {
return i;
}
}
return N.INDEX_NOT_FOUND;
}
/**
*
*
* @return
*/
public OptionalChar min() {
return size() == 0 ? OptionalChar.empty() : OptionalChar.of(N.min(elementData, 0, size));
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public OptionalChar min(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return fromIndex == toIndex ? OptionalChar.empty() : OptionalChar.of(N.min(elementData, fromIndex, toIndex));
}
/**
*
*
* @return
*/
public OptionalChar median() {
return size() == 0 ? OptionalChar.empty() : OptionalChar.of(N.median(elementData, 0, size));
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public OptionalChar median(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return fromIndex == toIndex ? OptionalChar.empty() : OptionalChar.of(N.median(elementData, fromIndex, toIndex));
}
/**
*
*
* @return
*/
public OptionalChar max() {
return size() == 0 ? OptionalChar.empty() : OptionalChar.of(N.max(elementData, 0, size));
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public OptionalChar max(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return fromIndex == toIndex ? OptionalChar.empty() : OptionalChar.of(N.max(elementData, fromIndex, toIndex));
}
/**
*
* @param k
* @return
*/
public OptionalChar kthLargest(final int k) {
return kthLargest(0, size(), k);
}
/**
*
* @param fromIndex
* @param toIndex
* @param k
* @return
*/
public OptionalChar kthLargest(final int fromIndex, final int toIndex, final int k) {
checkFromToIndex(fromIndex, toIndex);
N.checkArgPositive(k, "k");
return toIndex - fromIndex < k ? OptionalChar.empty() : OptionalChar.of(N.kthLargest(elementData, fromIndex, toIndex, k));
}
/**
*
*
* @return
*/
public int sum() {
return sum(0, size());
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public int sum(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return N.sum(elementData, fromIndex, toIndex);
}
/**
*
*
* @return
*/
public OptionalDouble average() {
return average(0, size());
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public OptionalDouble average(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return fromIndex == toIndex ? OptionalDouble.empty() : OptionalDouble.of(N.average(elementData, fromIndex, toIndex));
}
/**
*
* @param
* @param action
* @throws E the e
*/
public void forEach(Throwables.CharConsumer action) throws E {
forEach(0, size, action);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param action
* @throws E the e
*/
public void forEach(final int fromIndex, final int toIndex, Throwables.CharConsumer action) throws E {
N.checkFromToIndex(fromIndex < toIndex ? fromIndex : (toIndex == -1 ? 0 : toIndex), fromIndex < toIndex ? toIndex : fromIndex, size);
if (size > 0) {
if (fromIndex <= toIndex) {
for (int i = fromIndex; i < toIndex; i++) {
action.accept(elementData[i]);
}
} else {
for (int i = N.min(size - 1, fromIndex); i > toIndex; i--) {
action.accept(elementData[i]);
}
}
}
}
/**
*
* @param
* @param action
* @throws E the e
*/
public void forEachIndexed(Throwables.IndexedCharConsumer action) throws E {
forEachIndexed(0, size, action);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param action
* @throws E the e
*/
public void forEachIndexed(final int fromIndex, final int toIndex, Throwables.IndexedCharConsumer action) throws E {
N.checkFromToIndex(fromIndex < toIndex ? fromIndex : (toIndex == -1 ? 0 : toIndex), fromIndex < toIndex ? toIndex : fromIndex, size);
if (size > 0) {
if (fromIndex <= toIndex) {
for (int i = fromIndex; i < toIndex; i++) {
action.accept(i, elementData[i]);
}
} else {
for (int i = N.min(size - 1, fromIndex); i > toIndex; i--) {
action.accept(i, elementData[i]);
}
}
}
}
/**
*
*
* @return
*/
public OptionalChar first() {
return size() == 0 ? OptionalChar.empty() : OptionalChar.of(elementData[0]);
}
/**
*
*
* @return
*/
public OptionalChar last() {
return size() == 0 ? OptionalChar.empty() : OptionalChar.of(elementData[size() - 1]);
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalChar findFirst(Throwables.CharPredicate predicate) throws E {
for (int i = 0; i < size; i++) {
if (predicate.test(elementData[i])) {
return OptionalChar.of(elementData[i]);
}
}
return OptionalChar.empty();
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalChar findLast(Throwables.CharPredicate predicate) throws E {
for (int i = size - 1; i >= 0; i--) {
if (predicate.test(elementData[i])) {
return OptionalChar.of(elementData[i]);
}
}
return OptionalChar.empty();
}
/**
* Find first index.
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalInt findFirstIndex(Throwables.CharPredicate predicate) throws E {
for (int i = 0; i < size; i++) {
if (predicate.test(elementData[i])) {
return OptionalInt.of(i);
}
}
return OptionalInt.empty();
}
/**
* Find last index.
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalInt findLastIndex(Throwables.CharPredicate predicate) throws E {
for (int i = size - 1; i >= 0; i--) {
if (predicate.test(elementData[i])) {
return OptionalInt.of(i);
}
}
return OptionalInt.empty();
}
/**
* Returns whether all elements of this List match the provided predicate.
*
* @param
* @param filter
* @return
* @throws E the e
*/
public boolean allMatch(Throwables.CharPredicate filter) throws E {
return allMatch(0, size(), filter);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @return
* @throws E the e
*/
public boolean allMatch(final int fromIndex, final int toIndex, Throwables.CharPredicate filter) throws E {
checkFromToIndex(fromIndex, toIndex);
if (size > 0) {
for (int i = fromIndex; i < toIndex; i++) {
if (!filter.test(elementData[i])) {
return false;
}
}
}
return true;
}
/**
* Returns whether any elements of this List match the provided predicate.
*
* @param
* @param filter
* @return
* @throws E the e
*/
public boolean anyMatch(Throwables.CharPredicate filter) throws E {
return anyMatch(0, size(), filter);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @return
* @throws E the e
*/
public boolean anyMatch(final int fromIndex, final int toIndex, Throwables.CharPredicate filter) throws E {
checkFromToIndex(fromIndex, toIndex);
if (size > 0) {
for (int i = fromIndex; i < toIndex; i++) {
if (filter.test(elementData[i])) {
return true;
}
}
}
return false;
}
/**
* Returns whether no elements of this List match the provided predicate.
*
* @param
* @param filter
* @return
* @throws E the e
*/
public boolean noneMatch(Throwables.CharPredicate filter) throws E {
return noneMatch(0, size(), filter);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @return
* @throws E the e
*/
public boolean noneMatch(final int fromIndex, final int toIndex, Throwables.CharPredicate filter) throws E {
checkFromToIndex(fromIndex, toIndex);
if (size > 0) {
for (int i = fromIndex; i < toIndex; i++) {
if (filter.test(elementData[i])) {
return false;
}
}
}
return true;
}
/**
*
* @param
* @param filter
* @return
* @throws E the e
*/
public int count(Throwables.CharPredicate filter) throws E {
return count(0, size(), filter);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @return
* @throws E the e
*/
public int count(final int fromIndex, final int toIndex, Throwables.CharPredicate filter) throws E {
checkFromToIndex(fromIndex, toIndex);
return N.count(elementData, fromIndex, toIndex, filter);
}
/**
*
* @param
* @param filter
* @return a new List with the elements match the provided predicate.
* @throws E the e
*/
public CharList filter(Throwables.CharPredicate filter) throws E {
return filter(0, size(), filter);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @return
* @throws E the e
*/
public CharList filter(final int fromIndex, final int toIndex, Throwables.CharPredicate filter) throws E {
checkFromToIndex(fromIndex, toIndex);
return CharList.of(N.filter(elementData, fromIndex, toIndex, filter));
}
/**
*
* @param
* @param filter
* @param max
* @return a new List with the elements match the provided predicate.
* @throws E the e
*/
public CharList filter(Throwables.CharPredicate filter, int max) throws E {
return filter(0, size(), filter, max);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param filter
* @param max
* @return
* @throws E the e
*/
public CharList filter(final int fromIndex, final int toIndex, Throwables.CharPredicate filter, final int max) throws E {
checkFromToIndex(fromIndex, toIndex);
return CharList.of(N.filter(elementData, fromIndex, toIndex, filter, max));
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public CharList map(final Throwables.CharUnaryOperator mapper) throws E {
return map(0, size, mapper);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param mapper
* @return
* @throws E the e
*/
public CharList map(final int fromIndex, final int toIndex, final Throwables.CharUnaryOperator mapper) throws E {
checkFromToIndex(fromIndex, toIndex);
final CharList result = new CharList(toIndex - fromIndex);
for (int i = fromIndex; i < toIndex; i++) {
result.add(mapper.applyAsChar(elementData[i]));
}
return result;
}
/**
* Map to obj.
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public List mapToObj(final Throwables.CharFunction mapper) throws E {
return mapToObj(0, size, mapper);
}
/**
* Map to obj.
*
* @param
* @param
* @param fromIndex
* @param toIndex
* @param mapper
* @return
* @throws E the e
*/
public List mapToObj(final int fromIndex, final int toIndex, final Throwables.CharFunction mapper) throws E {
checkFromToIndex(fromIndex, toIndex);
final List result = new ArrayList<>(toIndex - fromIndex);
for (int i = fromIndex; i < toIndex; i++) {
result.add(mapper.apply(elementData[i]));
}
return result;
}
/**
* 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);
*
*
*
* @param
* @param accumulator
* @return
* @throws E the e
*/
public OptionalChar reduce(final Throwables.CharBinaryOperator accumulator) throws E {
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);
}
/**
* 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;
*
*
*
* @param
* @param identity
* @param accumulator
* @return
* @throws E the e
*/
public char reduce(final char identity, final Throwables.CharBinaryOperator accumulator) throws E {
if (isEmpty()) {
return identity;
}
char result = identity;
for (int i = 0; i < size; i++) {
result = accumulator.applyAsChar(result, elementData[i]);
}
return result;
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
@Override
public CharList distinct(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
if (toIndex - fromIndex > 1) {
return of(N.distinct(elementData, fromIndex, toIndex));
} else {
return of(N.copyOfRange(elementData, fromIndex, toIndex));
}
}
/**
* Checks for duplicates.
*
* @return
*/
@Override
public boolean hasDuplicates() {
return N.hasDuplicates(elementData, 0, size, false);
}
/**
*
*
* @return
*/
@Override
public boolean isSorted() {
return N.isSorted(elementData, 0, size);
}
/**
* Sort.
*/
@Override
public void sort() {
if (size > 1) {
N.sort(elementData, 0, size);
}
}
/**
* Parallel sort.
*/
public void parallelSort() {
if (size > 1) {
N.parallelSort(elementData, 0, size);
}
}
/**
* Reverse sort.
*/
@Override
public void reverseSort() {
if (size > 1) {
sort();
reverse();
}
}
/**
* This List should be sorted first.
*
* @param valueToFind
* @return
*/
public int binarySearch(final char valueToFind) {
return N.binarySearch(elementData, valueToFind);
}
/**
* This List should be sorted first.
*
* @param fromIndex
* @param toIndex
* @param valueToFind
* @return
*/
public int binarySearch(final int fromIndex, final int toIndex, final char valueToFind) {
checkFromToIndex(fromIndex, toIndex);
return N.binarySearch(elementData, fromIndex, toIndex, valueToFind);
}
/**
* Reverse.
*/
@Override
public void reverse() {
if (size > 1) {
N.reverse(elementData, 0, size);
}
}
/**
*
* @param fromIndex
* @param toIndex
*/
@Override
public void reverse(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
if (toIndex - fromIndex > 1) {
N.reverse(elementData, fromIndex, toIndex);
}
}
/**
*
* @param distance
*/
@Override
public void rotate(int distance) {
if (size > 1) {
N.rotate(elementData, distance);
}
}
/**
* Shuffle.
*/
@Override
public void shuffle() {
if (size() > 1) {
N.shuffle(elementData);
}
}
/**
*
* @param rnd
*/
@Override
public void shuffle(final Random rnd) {
if (size() > 1) {
N.shuffle(elementData, rnd);
}
}
/**
*
* @param i
* @param j
*/
@Override
public void swap(int i, int j) {
rangeCheck(i);
rangeCheck(j);
set(i, set(j, elementData[i]));
}
/**
*
*
* @return
*/
@Override
public CharList copy() {
return new CharList(N.copyOfRange(elementData, 0, size));
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
@Override
public CharList copy(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return new CharList(N.copyOfRange(elementData, fromIndex, toIndex));
}
/**
*
* @param fromIndex
* @param toIndex
* @param step
* @return
* @see N#copyOfRange(int[], int, int, int)
*/
@Override
public CharList copy(final int fromIndex, final int toIndex, final int step) {
checkFromToIndex(fromIndex < toIndex ? fromIndex : (toIndex == -1 ? 0 : toIndex), fromIndex < toIndex ? toIndex : fromIndex);
return new CharList(N.copyOfRange(elementData, fromIndex, toIndex, step));
}
/**
* Returns List of {@code CharList} with consecutive sub sequences of the elements, each of the same size (the final sequence may be smaller).
*
*
* @param fromIndex
* @param toIndex
* @param chunkSize the desired size of each sub sequence (the last may be smaller).
* @return
*/
@Override
public List split(final int fromIndex, final int toIndex, final int chunkSize) {
checkFromToIndex(fromIndex, toIndex);
final List list = N.split(elementData, fromIndex, toIndex, chunkSize);
@SuppressWarnings("rawtypes")
final List result = (List) list;
for (int i = 0, len = list.size(); i < len; i++) {
result.set(i, of(list.get(i)));
}
return result;
}
// @Override
// public List split(int fromIndex, int toIndex, CharPredicate predicate) {
// checkIndex(fromIndex, toIndex);
//
// final List result = new ArrayList<>();
// CharList piece = null;
//
// for (int i = fromIndex; i < toIndex;) {
// if (piece == null) {
// piece = CharList.of(N.EMPTY_CHAR_ARRAY);
// }
//
// if (predicate.test(elementData[i])) {
// piece.add(elementData[i]);
// i++;
// } else {
// result.add(piece);
// piece = null;
// }
// }
//
// if (piece != null) {
// result.add(piece);
// }
//
// return result;
// }
/**
*
* @param fromIndex
* @param toIndex
* @param delimiter
* @return
*/
@Override
public String join(int fromIndex, int toIndex, char delimiter) {
checkFromToIndex(fromIndex, toIndex);
return Strings.join(elementData, fromIndex, toIndex, delimiter);
}
/**
*
* @param fromIndex
* @param toIndex
* @param delimiter
* @return
*/
@Override
public String join(int fromIndex, int toIndex, String delimiter) {
checkFromToIndex(fromIndex, toIndex);
return Strings.join(elementData, fromIndex, toIndex, delimiter);
}
/**
* Trim to size.
*
* @return
*/
@Override
public CharList trimToSize() {
if (elementData.length > size) {
elementData = N.copyOfRange(elementData, 0, size);
}
return this;
}
/**
* Clear.
*/
@Override
public void clear() {
if (size > 0) {
N.fill(elementData, 0, size, (char) 0);
}
size = 0;
}
/**
* Checks if is empty.
*
* @return true, if is empty
*/
@Override
public boolean isEmpty() {
return size == 0;
}
/**
*
*
* @return
*/
@Override
public int size() {
return size;
}
/**
*
*
* @return
*/
public List boxed() {
return boxed(0, size);
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public List boxed(int fromIndex, int toIndex) {
checkFromToIndex(fromIndex, toIndex);
final List res = new ArrayList<>(toIndex - fromIndex);
for (int i = fromIndex; i < toIndex; i++) {
res.add(elementData[i]);
}
return res;
}
/**
*
*
* @return
*/
@Override
public char[] toArray() {
return N.copyOfRange(elementData, 0, size);
}
/**
* To int list.
*
* @return
*/
public IntList toIntList() {
final int[] a = new int[size];
for (int i = 0; i < size; i++) {
a[i] = elementData[i];//NOSONAR
}
return IntList.of(a);
}
/**
*
* @param
* @param fromIndex
* @param toIndex
* @param supplier
* @return
*/
@Override
public > C toCollection(final int fromIndex, final int toIndex, final IntFunction supplier) {
checkFromToIndex(fromIndex, toIndex);
final C c = supplier.apply(toIndex - fromIndex);
for (int i = fromIndex; i < toIndex; i++) {
c.add(elementData[i]);
}
return c;
}
/**
*
* @param fromIndex
* @param toIndex
* @param supplier
* @return
*/
@Override
public Multiset toMultiset(final int fromIndex, final int toIndex, final IntFunction> supplier) {
checkFromToIndex(fromIndex, toIndex);
final Multiset multiset = supplier.apply(toIndex - fromIndex);
for (int i = fromIndex; i < toIndex; i++) {
multiset.add(elementData[i]);
}
return multiset;
}
/**
*
*
* @return
*/
public CharIterator iterator() {
if (isEmpty()) {
return CharIterator.EMPTY;
}
return CharIterator.of(elementData, 0, size);
}
/**
*
*
* @return
*/
public CharStream stream() {
return CharStream.of(elementData, 0, size());
}
/**
*
* @param fromIndex
* @param toIndex
* @return
*/
public CharStream stream(final int fromIndex, final int toIndex) {
checkFromToIndex(fromIndex, toIndex);
return CharStream.of(elementData, fromIndex, toIndex);
}
/**
*
* @param
* @param
* @param func
* @return
* @throws E the e
*/
@Override
public R apply(Throwables.Function func) throws E {
return func.apply(this);
}
/**
* Apply if not empty.
*
* @param
* @param
* @param func
* @return
* @throws E the e
*/
@Override
public Optional applyIfNotEmpty(Throwables.Function func) throws E {
return isEmpty() ? Optional. empty() : Optional.ofNullable(func.apply(this));
}
/**
*
* @param
* @param action
* @throws E the e
*/
@Override
public void accept(Throwables.Consumer action) throws E {
action.accept(this);
}
/**
* Accept if not empty.
*
* @param
* @param action
* @return
* @throws E the e
*/
@Override
public OrElse acceptIfNotEmpty(Throwables.Consumer action) throws E {
return If.is(size > 0).then(this, action);
}
/**
*
*
* @return
*/
@Override
public int hashCode() {
return N.hashCode(elementData, 0, size);
}
/**
*
* @param obj
* @return
*/
@SuppressFBWarnings
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof CharList other) {
return this.size == other.size && N.equals(this.elementData, 0, other.elementData, 0, this.size);
}
return false;
}
/**
*
*
* @return
*/
@Override
public String toString() {
return size == 0 ? "[]" : N.toString(elementData, 0, size);
}
private void ensureCapacity(final int minCapacity) {
if (minCapacity > MAX_ARRAY_SIZE || minCapacity < 0) {
throw new OutOfMemoryError();
}
if (N.isNullOrEmpty(elementData)) {
elementData = new char[Math.max(DEFAULT_CAPACITY, minCapacity)];
} else if (minCapacity - elementData.length > 0) {
int newCapacity = calNewCapacity(minCapacity, elementData.length);
elementData = Arrays.copyOf(elementData, newCapacity);
}
}
}