com.landawn.abacus.util.CharIterator 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) 2016 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.util.NoSuchElementException;
import com.landawn.abacus.annotation.Beta;
import com.landawn.abacus.util.function.BooleanSupplier;
import com.landawn.abacus.util.function.CharSupplier;
import com.landawn.abacus.util.function.Supplier;
import com.landawn.abacus.util.stream.CharStream;
/**
*
* @author Haiyang Li
* @since 0.8
*/
public abstract class CharIterator extends ImmutableIterator {
public static final CharIterator EMPTY = new CharIterator() {
@Override
public boolean hasNext() {
return false;
}
@Override
public char nextChar() {
throw new NoSuchElementException();
}
};
public static CharIterator empty() {
return EMPTY;
}
/**
*
* @param a
* @return
*/
@SafeVarargs
public static CharIterator of(final char... a) {
return N.isNullOrEmpty(a) ? EMPTY : of(a, 0, a.length);
}
/**
*
* @param a
* @param fromIndex
* @param toIndex
* @return
*/
public static CharIterator of(final char[] a, final int fromIndex, final int toIndex) {
N.checkFromToIndex(fromIndex, toIndex, a == null ? 0 : a.length);
if (fromIndex == toIndex) {
return EMPTY;
}
return new CharIterator() {
private int cursor = fromIndex;
@Override
public boolean hasNext() {
return cursor < toIndex;
}
@Override
public char nextChar() {
if (cursor >= toIndex) {
throw new NoSuchElementException();
}
return a[cursor++];
}
@Override
public char[] toArray() {
return N.copyOfRange(a, cursor, toIndex);
}
@Override
public CharList toList() {
return CharList.of(N.copyOfRange(a, cursor, toIndex));
}
};
}
/**
* Lazy evaluation.
*
* @param arraySupplier
* @return
*/
public static CharIterator from(final Supplier arraySupplier) {
N.checkArgNotNull(arraySupplier, "arraySupplier");
return new CharIterator() {
private char[] aar = null;
private int len = 0;
private int cur = 0;
private boolean isInitialized = false;
@Override
public boolean hasNext() {
if (!isInitialized) {
init();
}
return cur < len;
}
@Override
public char nextChar() {
if (!isInitialized) {
init();
}
if (cur >= len) {
throw new NoSuchElementException();
}
return aar[cur++];
}
private void init() {
if (!isInitialized) {
isInitialized = true;
aar = arraySupplier.get();
len = N.len(aar);
}
}
};
}
/**
* Lazy evaluation.
*
* @param iteratorSupplier
* @return
*/
public static CharIterator defer(final Supplier iteratorSupplier) {
N.checkArgNotNull(iteratorSupplier, "iteratorSupplier");
return new CharIterator() {
private CharIterator iter = null;
private boolean isInitialized = false;
@Override
public boolean hasNext() {
if (!isInitialized) {
init();
}
return iter.hasNext();
}
@Override
public char nextChar() {
if (!isInitialized) {
init();
}
return iter.nextChar();
}
private void init() {
if (!isInitialized) {
isInitialized = true;
iter = iteratorSupplier.get();
}
}
};
}
/**
* Returns an infinite {@code CharIterator}.
*
* @param supplier
* @return
*/
public static CharIterator generate(final CharSupplier supplier) {
N.checkArgNotNull(supplier);
return new CharIterator() {
@Override
public boolean hasNext() {
return true;
}
@Override
public char nextChar() {
return supplier.getAsChar();
}
};
}
/**
*
* @param hasNext
* @param supplier
* @return
*/
public static CharIterator generate(final BooleanSupplier hasNext, final CharSupplier supplier) {
N.checkArgNotNull(hasNext);
N.checkArgNotNull(supplier);
return new CharIterator() {
@Override
public boolean hasNext() {
return hasNext.getAsBoolean();
}
@Override
public char nextChar() {
if (!hasNext()) {
throw new NoSuchElementException();
}
return supplier.getAsChar();
}
};
}
/**
*
* @return
* @deprecated use nextChar() instead.
*/
@Deprecated
@Override
public Character next() {
return nextChar();
}
public abstract char nextChar();
public char[] toArray() {
return toList().trimToSize().array();
}
public CharList toList() {
final CharList list = new CharList();
while (hasNext()) {
list.add(nextChar());
}
return list;
}
public CharStream stream() {
return CharStream.of(this);
}
@Beta
public ObjIterator indexed() {
return indexed(0);
}
@Beta
public ObjIterator indexed(final long startIndex) {
if (startIndex < 0) {
throw new IllegalArgumentException("Invalid start index: " + startIndex);
}
final CharIterator iter = this;
return new ObjIterator<>() {
private long idx = startIndex;
@Override
public boolean hasNext() {
return iter.hasNext();
}
@Override
public IndexedChar next() {
return IndexedChar.of(iter.nextChar(), idx++);
}
};
}
/**
* For each remaining.
*
* @param action
*/
@Override
@Deprecated
public void forEachRemaining(java.util.function.Consumer action) {
super.forEachRemaining(action);
}
/**
*
* @param
* @param action
* @throws E the e
*/
public void foreachRemaining(Throwables.CharConsumer action) throws E {
N.checkArgNotNull(action);
while (hasNext()) {
action.accept(nextChar());
}
}
/**
*
* @param
* @param action
* @throws E the e
*/
public void foreachIndexed(Throwables.IndexedCharConsumer action) throws E {
N.checkArgNotNull(action);
int idx = 0;
while (hasNext()) {
action.accept(idx++, nextChar());
}
}
}