Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

Consumer<T> — operace bez návratové hodnoty

Consumer<T> přijímá jeden argument a nevrací žádnou hodnotu. Představuje akce s vedlejšími účinky; accept operaci provede a andThen spojí dvě operace, které se vykonají za sebou.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

Consumer<T> action = value -> { /* side effect */ };
action.accept(value);
Consumer<T> combined = action.andThen(after);

java.util.function.Consumer<T> je funkční rozhraní, kterému lze přiřadit lambda výraz nebo odkaz na metodu. T určuje typ argumentu. Typickým použitím je vedlejší účinek, například připojení textu k vyrovnávací paměti, místo výpočtu návratové hodnoty.

Consumer.accept, deklarovaná jako void accept(T t), provede operaci se zadaným argumentem. void znamená, že neexistuje návratová hodnota, nikoli že operace vrací null.

andThen(Consumer<? super T> after) vrátí složený Consumer: při zavolání jeho accept obdrží obě operace stejný argument, nejprve původní operace a potom after. Výjimka se předá volajícímu; pokud ji vyvolá první operace, druhá se neprovede. Předání null jako after způsobí NullPointerException.

V příkladu přiřazení výsledku andThen do proměnné combined vyrovnávací paměť nezmění. Teprve combined.accept("Java") připojí text a poté jeho délku. Očekávaný výsledek je Java:4.

Příklady

import java.util.function.Consumer;

public class Main {
    public static void main(String[] args) {
        StringBuilder log = new StringBuilder();
        Consumer<String> append = text -> { log.append(text); };
        Consumer<String> appendLength = text -> {
            log.append(":").append(text.length());
        };

        Consumer<String> combined = append.andThen(appendLength);
        combined.accept("Java");
        System.out.println(log);
    }
}

Výsledek

Java:4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje