/*
* This is free and unencumbered software released into the public domain.
*
* Anyone is free to copy, modify, publish, use, compile, sell, or
* distribute this software, either in source code form or as a compiled
* binary, for any purpose, commercial or non-commercial, and by any
* means.
*
* In jurisdictions that recognize copyright laws, the author or authors
* of this software dedicate any and all copyright interest in the
* software to the public domain. We make this dedication for the benefit
* of the public at large and to the detriment of our heirs and
* successors. We intend this dedication to be an overt act of
* relinquishment in perpetuity of all present and future rights to this
* software under copyright law.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
* IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* For more information, please refer to <http://unlicense.org/>
*/
package java.util.function;
import java.util.Objects;
/**
* Represents an operation that accepts a single {@code char}-valued argument and
* returns no result. This is the primitive type specialization of
* {@link Consumer} for {@code char}. Unlike most other functional interfaces,
* {@code CharConsumer} is expected to operate via side-effects.
* <p>
* This is a <a href="package-summary.html">functional interface</a>
* whose functional method is {@link #accept(char)}.
*
* @see Consumer
* @author AqD
*/
@FunctionalInterface
public interface CharConsumer {
/**
* Performs this operation on the given argument.
*
* @param value the input argument
*/
void accept(char value);
/**
* Returns a composed {@code CharConsumer} that performs, in sequence, this
* operation followed by the {@code after} operation. If performing either
* operation throws an exception, it is relayed to the caller of the
* composed operation. If performing this operation throws an exception,
* the {@code after} operation will not be performed.
*
* @param after the operation to perform after this operation
* @return a composed {@code CharConsumer} that performs in sequence this
* operation followed by the {@code after} operation
* @throws NullPointerException if {@code after} is null
*/
default CharConsumer andThen(CharConsumer after) {
Objects.requireNonNull(after);
return (char t) -> {
accept(t);
after.accept(t);
};
}
}