com.github.robtimus.io.function

Interface IOConsumer<T>

Type Parameters:

T - The type of the input to the operation.

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface IOConsumer<T>

Represents an operation that accepts a single input argument and returns no result. This is the IOException throwing equivalent of Consumer.

Method Summary

Modifier and Type	Method and Description
void	accept(T t) Performs this operation on the given argument.
default IOConsumer<T>	andThen(IOConsumer<? super T> after) Returns a composed IOConsumer that performs, in sequence, this operation followed by the after operation.
static <T> IOConsumer<T>	checked(Consumer<? super T> operation) Returns an IOConsumer that performs the operation operation, and unwraps any UncheckedIOException that is thrown by throwing its cause.
static <T> Consumer<T>	unchecked(IOConsumer<? super T> operation) Returns a Consumer that performs the operation operation, and wraps any IOException that is thrown in an UncheckedIOException.

Method Detail

accept

void accept(T t)
     throws IOException

Performs this operation on the given argument.

Parameters:

t - The input argument.

Throws:

IOException - If an I/O error occurs.

andThen

default IOConsumer<T> andThen(IOConsumer<? super T> after)

Returns a composed IOConsumer that performs, in sequence, this operation followed by the 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 after operation will not be performed.

Parameters:

after - The operation to perform after this operation.

Returns:

A composed IOConsumer that performs in sequence this operation followed by the after operation.

Throws:

NullPointerException - If after is null.

unchecked

static <T> Consumer<T> unchecked(IOConsumer<? super T> operation)

Returns a Consumer that performs the operation operation, and wraps any IOException that is thrown in an UncheckedIOException.

Type Parameters:

T - The type of the input to the operation.

Parameters:

operation - The operation to perform when the returned operation is performed.

Returns:

A Consumer that performs the operation operation on its input, and wraps any IOException that is thrown in an UncheckedIOException.

Throws:

NullPointerException - If operation is null.

checked

static <T> IOConsumer<T> checked(Consumer<? super T> operation)

Returns an IOConsumer that performs the operation operation, and unwraps any UncheckedIOException that is thrown by throwing its cause.

Type Parameters:

T - The type of the input to the operation.

Parameters:

operation - The operation to perform when the returned operation is performed.

Returns:

An IOConsumer that performs the operation operation on its input, and unwraps any UncheckedIOException that is thrown.

Throws:

NullPointerException - If the given operation is null.