CKTIS / Java
String.format — formátování textu
String.format vytváří text z formátovacího řetězce a argumentů pomocí specifikátorů, jako jsou %s, %d a %.2f. Výslovně zadané Locale zajistí, že formátování čísel nezávisí na výchozím národním prostředí systému.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversionString.format je statická metoda, která vrací formátovaný String; výsledek sama nevypisuje. Formátovací řetězec kombinuje běžný text se specifikátory definovanými třídou Formatter. Argumenty se předávají za formátovacím řetězcem jako Object... args.
Přetížení String.format(String format, Object... args) používá Locale.getDefault(Locale.Category.FORMAT). Varianta String.format(Locale l, String format, Object... args) umožňuje zadat Locale výslovně; null znamená, že se nepoužije lokalizace. Příklad používá Locale.US, aby byl desetinným oddělovačem tečka.
Pro běžné konverze má syntaxe tvar %[argument_index$][flags][width][.precision]conversion. %s formátuje řetězcovou reprezentaci argumentu, %d desetinné celé číslo a %.2f číslo s plovoucí desetinnou čárkou se dvěma číslicemi za desetinným oddělovačem. %04d nastavuje minimální šířku čtyř znaků s doplněním nulami. %2$s vybere druhý argument. %% vloží znak %, aniž by spotřebovalo argument; %n vloží oddělovač řádků závislý na platformě.
Neplatný formátovací řetězec, nekompatibilní typ nebo chybějící povinný argument způsobí IllegalFormatException. Například %d nepřijímá String obsahující číslice. Přebytečné argumenty se ignorují a zacházení s hodnotami null závisí na konverzi. Mějte formátovací řetězec pod kontrolou a proměnná data předávejte jako argumenty.
Příklady
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);
}
}Výsledek
Ada | id=0007 | score=12.50 | 80%
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.