com.landawn.abacus.util.u 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) 2019, 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.ArrayList;
import java.util.List;
import java.util.NoSuchElementException;
import java.util.Objects;
import java.util.Set;
import java.util.function.Supplier;
import com.landawn.abacus.annotation.SuppressFBWarnings;
import com.landawn.abacus.util.stream.ByteStream;
import com.landawn.abacus.util.stream.CharStream;
import com.landawn.abacus.util.stream.DoubleStream;
import com.landawn.abacus.util.stream.FloatStream;
import com.landawn.abacus.util.stream.IntStream;
import com.landawn.abacus.util.stream.LongStream;
import com.landawn.abacus.util.stream.ShortStream;
import com.landawn.abacus.util.stream.Stream;
@SuppressWarnings("java:S1192")
public class u {//NOSONAR
private u() {
// utility class
}
/**
* The Class Optional.
*
* @param
*/
@com.landawn.abacus.annotation.Immutable
public static final class Optional implements Immutable {
/** Presents {@code Boolean.TRUE}. */
public static final Optional TRUE = new Optional<>(Boolean.TRUE);
/** Presents {@code Boolean.FALSE}. */
public static final Optional FALSE = new Optional<>(Boolean.FALSE);
private static final Optional EMPTY_STRING = new Optional<>(N.EMPTY_STRING);
/** The Constant EMPTY. */
private static final Optional EMPTY = new Optional<>();
/** The value. */
private final T value;
/**
* Instantiates a new optional.
*/
private Optional() {
this.value = null;
}
/**
* Instantiates a new optional.
*
* @param value
*/
private Optional(T value) {
this.value = N.checkArgNotNull(value);
}
/**
*
* @param
* @return
*/
public static Optional empty() {
return (Optional) EMPTY;
}
/**
*
*
* @param value
* @return
*/
public static Optional of(final String value) {
N.checkArgNotNull(value);
if (value.length() == 0) {
return EMPTY_STRING;
}
return new Optional<>(value);
}
/**
*
* @param
* @param value
* @return
*/
public static Optional of(final T value) {
return new Optional<>(value);
}
/**
*
*
* @param value
* @return
*/
public static Optional ofNullable(final String value) {
if (value == null) {
return empty();
} else if (value.length() == 0) {
return EMPTY_STRING;
}
return new Optional<>(value);
}
/**
*
* @param
* @param value
* @return
*/
public static Optional ofNullable(T value) {
if (value == null) {
return empty();
}
return new Optional<>(value);
}
/**
*
* @param
* @param op
* @return
*/
public static Optional from(java.util.Optional op) {
if (op.isPresent()) {
return of(op.get());
} else {
return empty();
}
}
/**
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public T get() throws NoSuchElementException {
return orElseThrow();
}
/**
* Checks if is present.
*
* @return true, if is present
*/
public boolean isPresent() {
return value != null;
}
/**
* Checks if is empty.
*
* @return true, if is empty
*/
public boolean isEmpty() {
return value == null;
}
/**
*
* @param
* @param action
* @return itself
* @throws E the e
*/
public Optional ifPresent(final Throwables.Consumer action) throws E {
N.checkArgNotNull(action, "action");
if (isPresent()) {
action.accept(value);
}
return this;
}
/**
* If present or else.
*
* @param
* @param
* @param action
* @param emptyAction
* @return itself
* @throws E the e
* @throws E2 the e2
*/
public Optional ifPresentOrElse(final Throwables.Consumer action,
final Throwables.Runnable emptyAction) throws E, E2 {
N.checkArgNotNull(action, "action");
N.checkArgNotNull(emptyAction, "emptyAction");
if (isPresent()) {
action.accept(value);
} else {
emptyAction.run();
}
return this;
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public Optional filter(final Throwables.Predicate predicate) throws E {
N.checkArgNotNull(predicate, "predicate");
if (isPresent() && predicate.test(value)) {
return this;
} else {
return empty();
}
}
/**
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Nullable map(final Throwables.Function mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return Nullable. of(mapper.apply(value));
} else {
return Nullable. empty();
}
}
/**
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Optional mapToNonNull(final Throwables.Function mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return Optional. of(mapper.apply(value));
} else {
return Optional. empty();
}
}
/**
* Map to boolean.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalBoolean mapToBoolean(final Throwables.ToBooleanFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalBoolean.of(mapper.applyAsBoolean(value));
} else {
return OptionalBoolean.empty();
}
}
/**
* Map to char.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalChar mapToChar(final Throwables.ToCharFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalChar.of(mapper.applyAsChar(value));
} else {
return OptionalChar.empty();
}
}
/**
* Map to byte.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalByte mapToByte(final Throwables.ToByteFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalByte.of(mapper.applyAsByte(value));
} else {
return OptionalByte.empty();
}
}
/**
* Map to short.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalShort mapToShort(final Throwables.ToShortFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalShort.of(mapper.applyAsShort(value));
} else {
return OptionalShort.empty();
}
}
/**
* Map to int.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalInt mapToInt(final Throwables.ToIntFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalInt.of(mapper.applyAsInt(value));
} else {
return OptionalInt.empty();
}
}
/**
* Map to long.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalLong mapToLong(final Throwables.ToLongFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalLong.of(mapper.applyAsLong(value));
} else {
return OptionalLong.empty();
}
}
/**
* Map to float.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalFloat mapToFloat(final Throwables.ToFloatFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalFloat.of(mapper.applyAsFloat(value));
} else {
return OptionalFloat.empty();
}
}
/**
* Map to double.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalDouble mapToDouble(final Throwables.ToDoubleFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalDouble.of(mapper.applyAsDouble(value));
} else {
return OptionalDouble.empty();
}
}
/**
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Optional flatMap(final Throwables.Function, E> mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return Objects.requireNonNull(mapper.apply(value));
} else {
return empty();
}
}
/**
*
*
* @param element
* @return
*/
public boolean contains(final T element) {
return isPresent() && N.equals(this.value, element);
}
/**
*
* @param
* @param supplier
* @return
* @throws E the e
*/
public Optional or(final Throwables.Supplier, E> supplier) throws E {
N.checkArgNotNull(supplier, "supplier");
if (isPresent()) {
return this;
} else {
return Objects.requireNonNull(supplier.get());
}
}
/**
*
* @return
* @deprecated using {@link #orElseNull()}
*/
@Deprecated
public T orNull() {
return isPresent() ? value : null;
}
/**
*
* @return
*/
public T orElseNull() {
return isPresent() ? value : null;
}
/**
*
* @param other
* @return
*/
public T orElse(T other) {
return isPresent() ? value : other;
}
/**
* Or else get.
*
* @param
* @param other
* @return
* @throws E the e
*/
public T orElseGet(final Throwables.Supplier other) throws E {
if (isPresent()) {
return value;
} else {
return other.get();
}
}
// public T orElseNull() {
// return isPresent() ? value : null;
// }
/**
* Or else throw.
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public T orElseThrow() throws NoSuchElementException {
if (isPresent()) {
return value;
} else {
throw new NoSuchElementException("No value is present");
}
}
/**
* Or else throw.
*
* @param
* @param exceptionSupplier
* @return
* @throws X the x
*/
public T orElseThrow(final Supplier exceptionSupplier) throws X {
if (isPresent()) {
return value;
} else {
throw exceptionSupplier.get();
}
}
/**
*
* @return
*/
public Stream stream() {
if (isPresent()) {
return Stream.of(value);
} else {
return Stream. empty();
}
}
/**
*
* @return
*/
public List toList() {
if (isPresent()) {
return N.asList(value);
} else {
return new ArrayList<>();
}
}
/**
*
* @return
*/
public Set toSet() {
if (isPresent()) {
return N.asSet(value);
} else {
return N.newHashSet();
}
}
/**
* To immutable list.
*
* @return
*/
public ImmutableList toImmutableList() {
if (isPresent()) {
return ImmutableList.of(value);
} else {
return ImmutableList. empty();
}
}
/**
* To immutable set.
*
* @return
*/
public ImmutableSet toImmutableSet() {
if (isPresent()) {
return ImmutableSet.of(value);
} else {
return ImmutableSet. empty();
}
}
/**
*
* @return
*/
public java.util.Optional toJdkOptional() {
if (isPresent()) {
return java.util.Optional.of(value);
} else {
return java.util.Optional.empty();
}
}
/**
*
* @return
* @deprecated to be removed in future version.
*/
@Deprecated
public java.util.Optional __() {//NOSONAR
return toJdkOptional();
}
/**
*
* @param obj
* @return
*/
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof Optional) {
final Optional other = (Optional) obj;
return N.equals(value, other.value);
}
return false;
}
/**
*
* @return
*/
@Override
public int hashCode() {
return N.hashCode(isPresent()) * 31 + N.hashCode(value);
}
/**
*
* @return
*/
@Override
public String toString() {
if (isPresent()) {
return String.format("Optional[%s]", N.toString(value));
}
return "Optional.empty";
}
}
/**
* The Class OptionalBoolean.
*/
@com.landawn.abacus.annotation.Immutable
public static final class OptionalBoolean implements Comparable, Immutable {
/** Presents {@code true}. */
public static final OptionalBoolean TRUE = new OptionalBoolean(true);
/** Presents {@code true}. */
public static final OptionalBoolean FALSE = new OptionalBoolean(false);
/** The Constant EMPTY. */
private static final OptionalBoolean EMPTY = new OptionalBoolean();
/** The value. */
private final boolean value;
/** The is present. */
private final boolean isPresent;
/**
* Instantiates a new optional boolean.
*/
private OptionalBoolean() {
this.value = false;
this.isPresent = false;
}
/**
* Instantiates a new optional boolean.
*
* @param value
*/
private OptionalBoolean(boolean value) {
this.value = value;
this.isPresent = true;
}
/**
*
* @return
*/
public static OptionalBoolean empty() {
return EMPTY;
}
/**
*
* @param value
* @return
*/
public static OptionalBoolean of(boolean value) {
return value ? TRUE : FALSE;
}
/**
*
* @param val
* @return
*/
public static OptionalBoolean ofNullable(Boolean val) {
if (val == null) {
return empty();
} else {
return of(val);
}
}
/**
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public boolean get() throws NoSuchElementException {
return orElseThrow();
}
/**
*
*
* @return
*/
public boolean isPresent() {
return isPresent;
}
/**
*
*
* @return
*/
public boolean isEmpty() {
return !isPresent;
}
/**
*
* @param
* @param action
* @return
* @throws E the e
*/
public OptionalBoolean ifPresent(final Throwables.BooleanConsumer action) throws E {
N.checkArgNotNull(action, "action");
if (isPresent) {
action.accept(value);
}
return this;
}
/**
* If present or else.
*
* @param
* @param
* @param action
* @param emptyAction
* @return
* @throws E the e
* @throws E2 the e2
*/
public OptionalBoolean ifPresentOrElse(final Throwables.BooleanConsumer action,
Throwables.Runnable emptyAction) throws E, E2 {
N.checkArgNotNull(action, "action");
N.checkArgNotNull(emptyAction, "emptyAction");
if (isPresent) {
action.accept(value);
} else {
emptyAction.run();
}
return this;
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalBoolean filter(final Throwables.BooleanPredicate predicate) throws E {
N.checkArgNotNull(predicate, "predicate");
if (isPresent && predicate.test(value)) {
return this;
} else {
return empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalBoolean map(final Throwables.BooleanUnaryOperator mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalBoolean.of(mapper.applyAsBoolean(value));
} else {
return empty();
}
}
/**
* Map to obj.
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Nullable mapToObj(final Throwables.BooleanFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Nullable.of(mapper.apply(value));
} else {
return Nullable. empty();
}
}
/**
*
*
* @param
* @param
* @param mapper
* @return
* @throws E
*/
public Optional mapToNonNull(final Throwables.BooleanFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Optional.of(mapper.apply(value));
} else {
return Optional. empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalBoolean flatMap(final Throwables.BooleanFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Objects.requireNonNull(mapper.apply(value));
} else {
return empty();
}
}
/**
*
* @param
* @param supplier
* @return
* @throws E the e
*/
public OptionalBoolean or(final Throwables.Supplier supplier) throws E {
if (isPresent) {
return this;
} else {
return Objects.requireNonNull(supplier.get());
}
}
/**
*
* @return
* @deprecated use {@link #orElse(false)}
*/
@Deprecated
public boolean orFalse() {
return isPresent ? value : false;
}
// public boolean orElseFalse() {
// return isPresent ? value : false;
// }
/**
*
* @return
* @deprecated use {@link #orElse(true)}
*/
@Deprecated
public boolean orTrue() {
return isPresent ? value : true;
}
// public boolean orElseTrue() {
// return isPresent ? value : true;
// }
/**
*
* @param other
* @return
*/
public boolean orElse(boolean other) {
return isPresent ? value : other;
}
/**
* Or else get.
*
* @param
* @param other
* @return
* @throws E the e
*/
public boolean orElseGet(final Throwables.BooleanSupplier other) throws E {
N.checkArgNotNull(other, "other");
if (isPresent) {
return value;
} else {
return other.getAsBoolean();
}
}
/**
* Or else throw.
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public boolean orElseThrow() throws NoSuchElementException {
if (isPresent) {
return value;
} else {
throw new NoSuchElementException("No value present");
}
}
/**
* Or else throw.
*
* @param
* @param exceptionSupplier
* @return
* @throws X the x
*/
public boolean orElseThrow(final Supplier exceptionSupplier) throws X {
N.checkArgNotNull(exceptionSupplier, "exceptionSupplier");
if (isPresent) {
return value;
} else {
throw exceptionSupplier.get();
}
}
/**
*
* @return
*/
public Stream stream() {
if (isPresent) {
return Stream.of(value);
} else {
return Stream.empty();
}
}
/**
*
* @return
*/
public List toList() {
if (isPresent()) {
return N.asList(value);
} else {
return new ArrayList<>();
}
}
/**
*
* @return
*/
public Set toSet() {
if (isPresent()) {
return N.asSet(value);
} else {
return N.newHashSet();
}
}
/**
* To immutable list.
*
* @return
*/
public ImmutableList toImmutableList() {
if (isPresent()) {
return ImmutableList.of(value);
} else {
return ImmutableList. empty();
}
}
/**
* To immutable set.
*
* @return
*/
public ImmutableSet toImmutableSet() {
if (isPresent()) {
return ImmutableSet.of(value);
} else {
return ImmutableSet. empty();
}
}
/**
*
* @return
*/
public Optional boxed() {
if (isPresent) {
return Optional.of(value);
} else {
return Optional. empty();
}
}
/**
*
* @param optional
* @return
*/
@Override
public int compareTo(final OptionalBoolean optional) {
if (optional == null || !optional.isPresent) {
return isPresent ? 1 : 0;
}
if (!isPresent) {
return -1;
}
return Boolean.compare(this.get(), optional.get());
}
/**
*
* @param obj
* @return
*/
@SuppressFBWarnings
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof OptionalBoolean other) {
return (isPresent && other.isPresent) ? value == other.value : isPresent == other.isPresent;
}
return false;
}
/**
*
* @return
*/
@Override
public int hashCode() {
return N.hashCode(isPresent) * 31 + N.hashCode(value);
}
/**
*
* @return
*/
@Override
public String toString() {
if (isPresent) {
return String.format("OptionalBoolean[%s]", value);
}
return "OptionalBoolean.empty";
}
}
/**
* The Class OptionalChar.
*/
@com.landawn.abacus.annotation.Immutable
public static final class OptionalChar implements Comparable, Immutable {
/** The Constant EMPTY. */
private static final OptionalChar EMPTY = new OptionalChar();
/** The Constant MIN_CACHED_VALUE. */
private static final char MIN_CACHED_VALUE = 0;
/** The Constant MAX_CACHED_VALUE. */
private static final char MAX_CACHED_VALUE = 128;
/** The Constant cached. */
private static final OptionalChar[] cached = new OptionalChar[MAX_CACHED_VALUE - MIN_CACHED_VALUE + 1];
static {
for (int i = 0; i < cached.length; i++) {
cached[i] = new OptionalChar((char) (i + MIN_CACHED_VALUE));
}
}
/** The value. */
private final char value;
/** The is present. */
private final boolean isPresent;
/**
* Instantiates a new optional char.
*/
private OptionalChar() {
this.value = 0;
this.isPresent = false;
}
/**
* Instantiates a new optional char.
*
* @param value
*/
private OptionalChar(char value) {
this.value = value;
this.isPresent = true;
}
/**
*
* @return
*/
public static OptionalChar empty() {
return EMPTY;
}
/**
*
* @param value
* @return
*/
public static OptionalChar of(char value) {
return value >= MIN_CACHED_VALUE && value <= MAX_CACHED_VALUE ? cached[value - MIN_CACHED_VALUE] : new OptionalChar(value);
}
/**
*
* @param val
* @return
*/
public static OptionalChar ofNullable(Character val) {
if (val == null) {
return empty();
} else {
return of(val);
}
}
/**
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public char get() throws NoSuchElementException {
return orElseThrow();
}
/**
*
*
* @return
*/
public boolean isPresent() {
return isPresent;
}
/**
*
*
* @return
*/
public boolean isEmpty() {
return !isPresent;
}
/**
*
* @param
* @param action
* @return
* @throws E the e
*/
public OptionalChar ifPresent(final Throwables.CharConsumer action) throws E {
N.checkArgNotNull(action, "action");
if (isPresent()) {
action.accept(value);
}
return this;
}
/**
* If present or else.
*
* @param
* @param
* @param action
* @param emptyAction
* @return
* @throws E the e
* @throws E2 the e2
*/
public OptionalChar ifPresentOrElse(final Throwables.CharConsumer action,
final Throwables.Runnable emptyAction) throws E, E2 {
N.checkArgNotNull(action, "action");
N.checkArgNotNull(emptyAction, "emptyAction");
if (isPresent()) {
action.accept(value);
} else {
emptyAction.run();
}
return this;
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalChar filter(final Throwables.CharPredicate predicate) throws E {
N.checkArgNotNull(predicate, "predicate");
if (isPresent() && predicate.test(value)) {
return this;
} else {
return empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalChar map(final Throwables.CharUnaryOperator mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return OptionalChar.of(mapper.applyAsChar(value));
} else {
return empty();
}
}
/**
* Map to int.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalInt mapToInt(final Throwables.ToIntFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalInt.of(mapper.applyAsInt(value));
} else {
return OptionalInt.empty();
}
}
/**
* Map to obj.
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Nullable mapToObj(final Throwables.CharFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return Nullable.of(mapper.apply(value));
} else {
return Nullable. empty();
}
}
/**
*
*
* @param
* @param
* @param mapper
* @return
* @throws E
*/
public Optional mapToNonNull(final Throwables.CharFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Optional.of(mapper.apply(value));
} else {
return Optional. empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalChar flatMap(final Throwables.CharFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent()) {
return Objects.requireNonNull(mapper.apply(value));
} else {
return empty();
}
}
/**
*
* @param
* @param supplier
* @return
* @throws E the e
*/
public OptionalChar or(final Throwables.Supplier supplier) throws E {
if (isPresent()) {
return this;
} else {
return Objects.requireNonNull(supplier.get());
}
}
/**
*
* @return
* @deprecated use {@link #orElseZero()}
*/
@Deprecated
public char orZero() {
return isPresent() ? value : 0;
}
/**
*
*
* @return
*/
public char orElseZero() {
return isPresent() ? value : 0;
}
/**
*
* @param other
* @return
*/
public char orElse(char other) {
return isPresent() ? value : other;
}
/**
* Or else get.
*
* @param
* @param other
* @return
* @throws E the e
*/
public char orElseGet(final Throwables.CharSupplier other) throws E {
N.checkArgNotNull(other, "other");
if (isPresent()) {
return value;
} else {
return other.getAsChar();
}
}
/**
* Or else throw.
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public char orElseThrow() throws NoSuchElementException {
if (isPresent()) {
return value;
} else {
throw new NoSuchElementException("No value present");
}
}
/**
* Or else throw.
*
* @param
* @param exceptionSupplier
* @return
* @throws X the x
*/
public char orElseThrow(final Supplier exceptionSupplier) throws X {
N.checkArgNotNull(exceptionSupplier, "exceptionSupplier");
if (isPresent()) {
return value;
} else {
throw exceptionSupplier.get();
}
}
/**
*
* @return
*/
public CharStream stream() {
if (isPresent) {
return CharStream.of(value);
} else {
return CharStream.empty();
}
}
/**
*
* @return
*/
public List toList() {
if (isPresent()) {
return N.asList(value);
} else {
return new ArrayList<>();
}
}
/**
*
* @return
*/
public Set toSet() {
if (isPresent()) {
return N.asSet(value);
} else {
return N.newHashSet();
}
}
/**
* To immutable list.
*
* @return
*/
public ImmutableList toImmutableList() {
if (isPresent()) {
return ImmutableList.of(value);
} else {
return ImmutableList. empty();
}
}
/**
* To immutable set.
*
* @return
*/
public ImmutableSet toImmutableSet() {
if (isPresent()) {
return ImmutableSet.of(value);
} else {
return ImmutableSet. empty();
}
}
/**
*
* @return
*/
public Optional boxed() {
if (isPresent()) {
return Optional.of(value);
} else {
return Optional. empty();
}
}
/**
*
* @param optional
* @return
*/
@Override
public int compareTo(final OptionalChar optional) {
if (optional == null || !optional.isPresent()) {
return isPresent ? 1 : 0;
}
if (!isPresent) {
return -1;
}
return Character.compare(this.get(), optional.get());
}
/**
*
* @param obj
* @return
*/
@SuppressFBWarnings
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof OptionalChar other) {
return (isPresent && other.isPresent) ? value == other.value : isPresent == other.isPresent;
}
return false;
}
/**
*
* @return
*/
@Override
public int hashCode() {
return N.hashCode(isPresent()) * 31 + N.hashCode(value);
}
/**
*
* @return
*/
@Override
public String toString() {
if (isPresent()) {
return String.format("OptionalChar[%s]", value);
}
return "OptionalChar.empty";
}
}
/**
* The Class OptionalByte.
*/
@com.landawn.abacus.annotation.Immutable
public static final class OptionalByte implements Comparable, Immutable {
/** The Constant EMPTY. */
private static final OptionalByte EMPTY = new OptionalByte();
/** The Constant MIN_CACHED_VALUE. */
private static final byte MIN_CACHED_VALUE = Byte.MIN_VALUE;
/** The Constant MAX_CACHED_VALUE. */
private static final byte MAX_CACHED_VALUE = Byte.MAX_VALUE;
/** The Constant cached. */
private static final OptionalByte[] cached = new OptionalByte[MAX_CACHED_VALUE - MIN_CACHED_VALUE + 1];
static {
for (int i = 0; i < cached.length; i++) {
cached[i] = new OptionalByte((byte) (i + MIN_CACHED_VALUE));
}
}
/** The value. */
private final byte value;
/** The is present. */
private final boolean isPresent;
/**
* Instantiates a new optional byte.
*/
private OptionalByte() {
this.value = 0;
this.isPresent = false;
}
/**
* Instantiates a new optional byte.
*
* @param value
*/
private OptionalByte(byte value) {
this.value = value;
this.isPresent = true;
}
/**
*
* @return
*/
public static OptionalByte empty() {
return EMPTY;
}
/**
*
* @param value
* @return
*/
public static OptionalByte of(byte value) {
return cached[value - MIN_CACHED_VALUE];
}
/**
*
* @param val
* @return
*/
public static OptionalByte ofNullable(Byte val) {
if (val == null) {
return empty();
} else {
return OptionalByte.of(val);
}
}
/**
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public byte get() throws NoSuchElementException {
return orElseThrow();
}
/**
*
*
* @return
*/
public boolean isPresent() {
return isPresent;
}
/**
*
*
* @return
*/
public boolean isEmpty() {
return !isPresent;
}
/**
*
* @param
* @param action
* @return
* @throws E the e
*/
public OptionalByte ifPresent(final Throwables.ByteConsumer action) throws E {
N.checkArgNotNull(action, "action");
if (isPresent) {
action.accept(value);
}
return this;
}
/**
* If present or else.
*
* @param
* @param
* @param action
* @param emptyAction
* @return
* @throws E the e
* @throws E2 the e2
*/
public OptionalByte ifPresentOrElse(final Throwables.ByteConsumer action,
final Throwables.Runnable emptyAction) throws E, E2 {
N.checkArgNotNull(action, "action");
N.checkArgNotNull(emptyAction, "emptyAction");
if (isPresent) {
action.accept(value);
} else {
emptyAction.run();
}
return this;
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalByte filter(final Throwables.BytePredicate predicate) throws E {
N.checkArgNotNull(predicate, "predicate");
if (isPresent && predicate.test(value)) {
return this;
} else {
return empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalByte map(final Throwables.ByteUnaryOperator mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalByte.of(mapper.applyAsByte(value));
} else {
return empty();
}
}
/**
* Map to int.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalInt mapToInt(final Throwables.ToIntFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalInt.of(mapper.applyAsInt(value));
} else {
return OptionalInt.empty();
}
}
/**
* Map to obj.
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Nullable mapToObj(final Throwables.ByteFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Nullable.of(mapper.apply(value));
} else {
return Nullable. empty();
}
}
/**
*
*
* @param
* @param
* @param mapper
* @return
* @throws E
*/
public Optional mapToNonNull(final Throwables.ByteFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Optional.of(mapper.apply(value));
} else {
return Optional. empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalByte flatMap(final Throwables.ByteFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Objects.requireNonNull(mapper.apply(value));
} else {
return empty();
}
}
/**
*
* @param
* @param supplier
* @return
* @throws E the e
*/
public OptionalByte or(final Throwables.Supplier supplier) throws E {
if (isPresent) {
return this;
} else {
return Objects.requireNonNull(supplier.get());
}
}
/**
*
* @return
* @deprecated use {@link #orElseZero()}
*/
@Deprecated
public byte orZero() {
return isPresent ? value : 0;
}
/**
*
*
* @return
*/
public byte orElseZero() {
return isPresent ? value : 0;
}
/**
*
* @param other
* @return
*/
public byte orElse(byte other) {
return isPresent ? value : other;
}
/**
* Or else get.
*
* @param
* @param other
* @return
* @throws E the e
*/
public byte orElseGet(final Throwables.ByteSupplier other) throws E {
N.checkArgNotNull(other, "other");
if (isPresent) {
return value;
} else {
return other.getAsByte();
}
}
/**
* Or else throw.
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public byte orElseThrow() throws NoSuchElementException {
if (isPresent) {
return value;
} else {
throw new NoSuchElementException("No value present");
}
}
/**
* Or else throw.
*
* @param
* @param exceptionSupplier
* @return
* @throws X the x
*/
public byte orElseThrow(final Supplier exceptionSupplier) throws X {
N.checkArgNotNull(exceptionSupplier, "exceptionSupplier");
if (isPresent) {
return value;
} else {
throw exceptionSupplier.get();
}
}
/**
*
* @return
*/
public ByteStream stream() {
if (isPresent) {
return ByteStream.of(value);
} else {
return ByteStream.empty();
}
}
/**
*
* @return
*/
public List toList() {
if (isPresent()) {
return N.asList(value);
} else {
return new ArrayList<>();
}
}
/**
*
* @return
*/
public Set toSet() {
if (isPresent()) {
return N.asSet(value);
} else {
return N.newHashSet();
}
}
/**
* To immutable list.
*
* @return
*/
public ImmutableList toImmutableList() {
if (isPresent()) {
return ImmutableList.of(value);
} else {
return ImmutableList. empty();
}
}
/**
* To immutable set.
*
* @return
*/
public ImmutableSet toImmutableSet() {
if (isPresent()) {
return ImmutableSet.of(value);
} else {
return ImmutableSet. empty();
}
}
/**
*
* @return
*/
public Optional boxed() {
if (isPresent) {
return Optional.of(value);
} else {
return Optional. empty();
}
}
/**
*
* @param optional
* @return
*/
@Override
public int compareTo(final OptionalByte optional) {
if (optional == null || !optional.isPresent) {
return isPresent ? 1 : 0;
}
if (!isPresent) {
return -1;
}
return Byte.compare(this.get(), optional.get());
}
/**
*
* @param obj
* @return
*/
@SuppressFBWarnings
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof OptionalByte other) {
return (isPresent && other.isPresent) ? value == other.value : isPresent == other.isPresent;
}
return false;
}
/**
*
* @return
*/
@Override
public int hashCode() {
return N.hashCode(isPresent) * 31 + N.hashCode(value);
}
/**
*
* @return
*/
@Override
public String toString() {
if (isPresent) {
return String.format("OptionalByte[%s]", value);
}
return "OptionalByte.empty";
}
}
/**
* The Class OptionalShort.
*/
@com.landawn.abacus.annotation.Immutable
public static final class OptionalShort implements Comparable, Immutable {
/** The Constant EMPTY. */
private static final OptionalShort EMPTY = new OptionalShort();
/** The Constant MIN_CACHED_VALUE. */
private static final short MIN_CACHED_VALUE = -128;
/** The Constant MAX_CACHED_VALUE. */
private static final short MAX_CACHED_VALUE = 256;
/** The Constant cached. */
private static final OptionalShort[] cached = new OptionalShort[MAX_CACHED_VALUE - MIN_CACHED_VALUE + 1];
static {
for (int i = 0; i < cached.length; i++) {
cached[i] = new OptionalShort((short) (i + MIN_CACHED_VALUE));
}
}
/** The value. */
private final short value;
/** The is present. */
private final boolean isPresent;
/**
* Instantiates a new optional short.
*/
private OptionalShort() {
this.value = 0;
this.isPresent = false;
}
/**
* Instantiates a new optional short.
*
* @param value
*/
private OptionalShort(short value) {
this.value = value;
this.isPresent = true;
}
/**
*
* @return
*/
public static OptionalShort empty() {
return EMPTY;
}
/**
*
* @param value
* @return
*/
public static OptionalShort of(short value) {
return value >= MIN_CACHED_VALUE && value <= MAX_CACHED_VALUE ? cached[value - MIN_CACHED_VALUE] : new OptionalShort(value);
}
/**
*
* @param val
* @return
*/
public static OptionalShort ofNullable(Short val) {
if (val == null) {
return empty();
} else {
return OptionalShort.of(val);
}
}
/**
*
* @return
* @throws NoSuchElementException the no such element exception
*/
public short get() throws NoSuchElementException {
return orElseThrow();
}
/**
*
*
* @return
*/
public boolean isPresent() {
return isPresent;
}
/**
*
*
* @return
*/
public boolean isEmpty() {
return !isPresent;
}
/**
*
* @param
* @param action
* @return
* @throws E the e
*/
public OptionalShort ifPresent(final Throwables.ShortConsumer action) throws E {
N.checkArgNotNull(action, "action");
if (isPresent) {
action.accept(value);
}
return this;
}
/**
* If present or else.
*
* @param
* @param
* @param action
* @param emptyAction
* @return
* @throws E the e
* @throws E2 the e2
*/
public OptionalShort ifPresentOrElse(final Throwables.ShortConsumer action,
Throwables.Runnable emptyAction) throws E, E2 {
N.checkArgNotNull(action, "action");
N.checkArgNotNull(emptyAction, "emptyAction");
if (isPresent) {
action.accept(value);
} else {
emptyAction.run();
}
return this;
}
/**
*
* @param
* @param predicate
* @return
* @throws E the e
*/
public OptionalShort filter(final Throwables.ShortPredicate predicate) throws E {
N.checkArgNotNull(predicate, "predicate");
if (isPresent && predicate.test(value)) {
return this;
} else {
return empty();
}
}
/**
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalShort map(final Throwables.ShortUnaryOperator mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalShort.of(mapper.applyAsShort(value));
} else {
return empty();
}
}
/**
* Map to int.
*
* @param
* @param mapper
* @return
* @throws E the e
*/
public OptionalInt mapToInt(final Throwables.ToIntFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return OptionalInt.of(mapper.applyAsInt(value));
} else {
return OptionalInt.empty();
}
}
/**
* Map to obj.
*
* @param
* @param
* @param mapper
* @return
* @throws E the e
*/
public Nullable mapToObj(final Throwables.ShortFunction mapper) throws E {
N.checkArgNotNull(mapper, "mapper");
if (isPresent) {
return Nullable.of(mapper.apply(value));
} else {
return Nullable.