Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Function.andThen — appliquer cette fonction, puis la suivante

`Function.andThen` renvoie une fonction composée qui applique d’abord la fonction sur laquelle la méthode a été appelée, puis transmet son résultat à `after`.

Version : Java SE 21

Syntaxe

default <V> Function<T, V> andThen(Function<? super R, ? extends V> after)

Function.andThen est une méthode par défaut de l’interface java.util.function.Function<T, R>. L’appel f.andThen(g) renvoie une fonction composée sans exécuter f ni g. C’est l’appel à apply(x) sur cette fonction qui évalue g.apply(f.apply(x)) : d’abord f (this), puis g (after).

Le type d’entrée T ne change pas. La fonction after doit pouvoir accepter le résultat de type R : son type d’entrée peut être R ou un supertype de R (? super R). Elle peut renvoyer V ou un sous-type de V (? extends V). La fonction composée est de type Function<T, V>.

Avec f.compose(g), l’ordre est inversé : g s’exécute d’abord, puis f. Si les types sont compatibles, f.andThen(g) et g.compose(f) effectuent les mêmes étapes dans le même ordre.

Si after vaut null, l’appel à andThen lève immédiatement une NullPointerException. Si la première étape lève une exception pendant apply, la deuxième ne s’exécute pas. Toute exception levée à l’une ou l’autre étape remonte jusqu’au code qui appelle la fonction composée. Un résultat null à la première étape n’interrompt pas l’évaluation : il est transmis à la deuxième fonction.

Exemples

import java.util.function.Function;

public class AndThenDemo {
    public static void main(String[] args) {
        Function<String, String> strip = String::strip;
        Function<String, Integer> length = String::length;

        Function<String, Integer> strippedLength = strip.andThen(length);
        System.out.println(strippedLength.apply(" Java "));
    }
}

Résultat

4

`strip` enlève les espaces aux deux extrémités de `" Java "`, puis `length` mesure la longueur de `"Java"`. La sortie attendue est `4`, et non `6`.

Leçons associées

  • Java · Leçon 48 · Intermédiaire · Version : 2

Sources