ru.progrm_jarvis.javacommons.util.function.BooleanConsumer Maven / Gradle / Ivy

Go to download
package ru.progrm_jarvis.javacommons.util.function;

import lombok.NonNull;
import org.jetbrains.annotations.NotNull;

import java.util.function.Consumer;

/**
 * Represents an operation that accepts a single {@code boolean} argument and returns no result.
 * This is the primitive type specialization of {@link Consumer} for {@code boolean}.
 *
 * @see Consumer non-primitive generic equivalent
 */
@FunctionalInterface
public interface BooleanConsumer extends Consumer {

    /**
     * Performs this operation on the given argument.
     *
     * @param value the input argument
     */
    void accept(boolean value);

    @Override
    default void accept(final Boolean value /* no need for explicit null-check */) {
        accept(value.booleanValue());
    }

    @Override
    default @NotNull Consumer andThen(final @NonNull Consumer after) {
        return value -> {
            accept(value);
            after.accept(value);
        };
    }

    /**
     * Returns a composed consumer that performs, in sequence, this operation followed by the {@code after} operation.
     *
     * @param after the operation to perform after this operation
     * @return a composed operator that first performs this operation and then the provided one
     * @throws NullPointerException if {@code after} is {@code null}
     */
    default BooleanConsumer andThenPrimitive(final @NonNull BooleanConsumer after) {
        return value -> {
            accept(value);
            after.accept(value);
        };
    }
}