Interface BiConsumer<T,​U>

Type Parameters:
T - the type of the first argument to the operation
U - the type of the second argument to the operation
All Superinterfaces:
BiConsumer<T,​U>
All Known Subinterfaces:
ObjDoubleConsumer<T>, ObjIntConsumer<T>, ObjLongConsumer<T>
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 BiConsumer<T,​U>
extends BiConsumer<T,​U>
Represents an operation that accepts two input arguments and returns no result. This is the two-arity specialization of Consumer. Unlike most other functional interfaces, BiConsumer is expected to operate via side-effects.

This is a functional interface whose functional method is accept(Object, Object).

Since:
1.8
See Also:
Consumer
  • Method Summary

    Modifier and Type Method Description
    void accept​(T t, U u)
    Performs this operation on the given arguments.
    default BiConsumer<T,​U> andThen​(BiConsumer<? super T,​? super U> after)
    Returns a composed BiConsumer that performs, in sequence, this operation followed by the after operation.
    default BiConsumer<T,​U> andThenL​(Consumer<? super T> after)
    Returns a composed BiConsumer that performs, in sequence, this operation followed by the after operation.
    default BiConsumer<T,​U> andThenR​(Consumer<? super U> after)
    Returns a composed BiConsumer that performs, in sequence, this operation followed by the after operation.
    default Runnable applyPartial​(T t, U u)
    Partially apply a parameter such that a single param consumer becomes a no-param runnable.
    default Consumer<U> applyPartialL​(T t)
    Performs a partial application, resulting in a consumer that calls this with its argument and the argument given here.
    default Consumer<T> applyPartialR​(U u)
    Performs a partial application, resulting in a consumer that calls this with its argument and the argument given here.

    Methods inherited from interface java.util.function.BiConsumer

    andThen
  • Method Details

    • accept

      void accept​(T t, U u)
      Performs this operation on the given arguments.
      Specified by:
      accept in interface BiConsumer<T,​U>
      Parameters:
      t - the first input argument
      u - the second input argument
    • andThen

      default BiConsumer<T,​U> andThen​(BiConsumer<? super T,​? super U> after)
      Returns a composed BiConsumer 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 BiConsumer that performs in sequence this operation followed by the after operation
      Throws:
      NullPointerException - if after is null
    • andThenL

      default BiConsumer<T,​U> andThenL​(Consumer<? super T> after)
      Returns a composed BiConsumer 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 BiConsumer that performs in sequence this operation followed by the after operation
      Throws:
      NullPointerException - if after is null
    • andThenR

      default BiConsumer<T,​U> andThenR​(Consumer<? super U> after)
      Returns a composed BiConsumer 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 BiConsumer that performs in sequence this operation followed by the after operation
      Throws:
      NullPointerException - if after is null
    • applyPartial

      default Runnable applyPartial​(T t, U u)
      Partially apply a parameter such that a single param consumer becomes a no-param runnable.
      Parameters:
      t - The first parameter to apply.
      u - The second parameter to apply.
      Returns:
      A partially-applied function.
    • applyPartialL

      default Consumer<U> applyPartialL​(T t)
      Performs a partial application, resulting in a consumer that calls this with its argument and the argument given here.
      Parameters:
      t - the function argument
      Returns:
      the function result
    • applyPartialR

      default Consumer<T> applyPartialR​(U u)
      Performs a partial application, resulting in a consumer that calls this with its argument and the argument given here.
      Parameters:
      u - the function argument
      Returns:
      the function result