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

CKTIS / Java

AbstractMap.toString — représentation textuelle d’une map

AbstractMap.toString renvoie un texte contenant les associations clé-valeur. Leur ordre est déterminé par l’itérateur de entrySet(), et non par un tri automatique.

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

Syntaxe

public String toString()
// Usage:
String text = map.toString();

AbstractMap.toString est une méthode d’instance sans argument qui renvoie un String ; elle redéfinit Object.toString(). Elle représente une map sous la forme {key=value, key=value}. Une map vide produit {} ; les associations successives sont séparées par , .

L’ordre est déterminé par l’itérateur de entrySet() : la méthode ne trie pas les entrées. Les clés et les valeurs sont normalement converties comme avec String.valueOf(Object) : null devient le texte null, et pour les autres objets, c’est leur propre méthode toString() qui est appelée. Une map peut toutefois se contenir elle-même comme valeur. Dans ce cas, l’implémentation héritée de AbstractMap.toString dans OpenJDK 21 représente cette valeur par (this Map) au lieu d’appeler récursivement toString() sur la même map. La spécification Java SE ne garantit pas ce marqueur. Ne considère pas cette représentation comme du JSON ni comme un format fiable d’échange de données.

L’exemple utilise LinkedHashMap, dont l’ordre par défaut suit l’ordre d’insertion. Le type de la variable AbstractMap ne modifie pas la classe réelle de l’objet ; une sous-classe peut redéfinir toString(). Cette description concerne Java SE 21 ; l’environnement d’exécution de production n’a pas été attesté.

Exemples

import java.util.AbstractMap;
import java.util.LinkedHashMap;

public class Main {
    public static void main(String[] args) {
        AbstractMap<String, Integer> map = new LinkedHashMap<>();
        map.put("beta", 2);
        map.put("alpha", 1);
        map.put("missing", null);
        System.out.println(map.toString());
        map.clear();
        System.out.println(map.toString());
    }
}

Résultat

{beta=2, alpha=1, missing=null}
{}

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources