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

CKTIS / Java

Map.compute : recalculer la valeur associée à une clé

Utilisez `Map.compute` pour appliquer la même fonction que la clé soit présente ou absente. Renvoyez `null` depuis la fonction pour supprimer l’entrée.

Version : Java SE 21

Syntaxe

default V compute(K key, BiFunction<? super K, ? super V, ? extends V> remappingFunction)

Map.compute est une méthode par défaut de java.util.Map<K, V>, disponible depuis Java 8. Dans map.compute(key, (k, v) -> ...), la fonction est appelée que la clé soit présente ou absente. Elle reçoit la clé fournie dans k et la valeur actuelle dans v.

La fonction reçoit v == null aussi bien lorsque la clé est absente que lorsqu’elle est associée à null. Si cette distinction est importante, utilisez containsKey sur une map qui accepte les valeurs null, comme HashMap. Un résultat différent de null est enregistré et renvoyé par compute. Un résultat null supprime l’entrée si elle existe ou laisse la clé absente ; dans les deux cas, compute renvoie null.

À l’inverse, computeIfAbsent appelle sa fonction uniquement si la clé est absente ou associée à null, et ne lui transmet que la clé. computeIfPresent transmet la clé et la valeur, mais n’appelle sa fonction que si la valeur actuelle est différente de null.

Ne modifiez pas la même map depuis la fonction. Si la fonction lève une exception non contrôlée, compute la propage et laisse l’association inchangée. Passer null à la place d’une fonction provoque une NullPointerException, et une map qui ne prend pas en charge la modification peut lever une UnsupportedOperationException. L’implémentation par défaut ne garantit pas l’atomicité ; avec ConcurrentHashMap.compute, l’appel entier est atomique, alors veillez à ce que la fonction s’exécute rapidement.

Exemples

import java.util.HashMap;
import java.util.Map;
import java.util.function.BiFunction;

public class Main {
    public static void main(String[] args) {
        Map<String, Integer> counts = new HashMap<>();
        BiFunction<String, Integer, Integer> increment = (k, v) -> v == null ? 1 : v + 1;

        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", increment));
        System.out.println(counts.compute("visits", (k, v) -> null));
        System.out.println(counts.containsKey("visits"));
    }
}

Résultat

1
2
null
false

Le premier appel initialise le compteur `visits` à `1`, le deuxième le fait passer à `2` et le troisième supprime l’entrée et renvoie `null`. Le dernier `false` confirme que la clé est absente et non associée à `null`.

Leçons associées

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

Sources