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

CKTIS / Java

AbstractMap.toString — textová reprezentace mapy

AbstractMap.toString vrací text obsahující dvojice klíč–hodnota. Jejich pořadí určuje iterátor entrySet(), nikoli automatické řazení.

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

Syntaxe

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

AbstractMap.toString je bezargumentová instanční metoda vracející String; přepisuje Object.toString(). Mapu znázorňuje ve tvaru {key=value, key=value}. Prázdná mapa vrátí {}; jednotlivé dvojice jsou odděleny pomocí , .

Pořadí určuje iterátor entrySet(): metoda položky netřídí. Klíče a hodnoty se obvykle převádějí jako při volání String.valueOf(Object): null se změní na text null a u ostatních objektů se zavolá jejich metoda toString(). Mapa však může jako hodnotu obsahovat sama sebe. V takovém případě zděděná implementace AbstractMap.toString v OpenJDK 21 zobrazí tuto hodnotu jako (this Map) místo toho, aby rekurzivně volala toString() nad toutéž mapou. Specifikace Java SE tuto značku nezaručuje. Tuto reprezentaci nepovažuj za JSON ani za spolehlivý formát pro výměnu dat.

Příklad používá LinkedHashMap, jejíž výchozí pořadí odpovídá pořadí vkládání. Typ proměnné AbstractMap nemění skutečnou třídu objektu; podtřída může přepsat toString(). Tento popis se vztahuje k Java SE 21; produkční běhové prostředí nebylo ověřeno.

Příklady

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());
    }
}

Výsledek

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

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