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]conversionString.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.