WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.format — Text formatieren

String.format erstellt aus einer Formatzeichenfolge und Argumenten Text und verwendet Platzhalter wie %s, %d und %.2f. Ein explizites Locale macht die Zahlenformatierung unabhängig von den Standardeinstellungen der Umgebung.

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

Syntax

String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversion

String.format ist eine statische Methode, die einen formatierten String zurückgibt; sie gibt das Ergebnis nicht selbst aus. Die Formatzeichenfolge verbindet normalen Text mit von Formatter definierten Platzhaltern. Die Argumente folgen auf die Formatzeichenfolge und werden als Object... args übergeben.

Die Überladung String.format(String format, Object... args) verwendet Locale.getDefault(Locale.Category.FORMAT). Mit der Variante String.format(Locale l, String format, Object... args) lässt sich das Locale ausdrücklich festlegen; null bedeutet, dass keine Lokalisierung verwendet wird. Das Beispiel verwendet Locale.US, damit der Dezimaltrenner ein Punkt ist.

Für gängige Konvertierungen lautet die Syntax %[argument_index$][flags][width][.precision]conversion. %s formatiert die Zeichenfolgendarstellung eines Arguments, %d eine Dezimalzahl als Ganzzahl und %.2f eine Gleitkommazahl mit zwei Stellen nach dem Dezimaltrenner. %04d legt eine Mindestbreite von vier Zeichen mit Nullen als Auffüllung fest. %2$s wählt das zweite Argument aus. %% fügt ein wörtliches % ein, ohne ein Argument zu verbrauchen; %n fügt den plattformspezifischen Zeilenumbruch ein.

Eine ungültige Formatzeichenfolge, ein inkompatibler Typ oder ein fehlendes erforderliches Argument führt zu IllegalFormatException. Zum Beispiel akzeptiert %d keinen String, der Ziffern enthält. Zusätzliche Argumente werden ignoriert; wie null behandelt wird, hängt von der Konvertierung ab. Behalte die Kontrolle über die Formatzeichenfolge und übergib variable Daten als Argumente.

Beispiele

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        String result = String.format(
            Locale.US, "%s | id=%04d | score=%.2f | %d%%",
            "Ada", 7, 12.5, 80
        );
        System.out.print(result);
    }
}

Ergebnis

Ada | id=0007 | score=12.50 | 80%

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen