CKTIS / Java
String.format — formátovanie textu
String.format vytvára text z formátovacieho reťazca a argumentov pomocou špecifikátorov, ako sú %s, %d a %.2f. Výslovne zadané Locale zabezpečí, že formátovanie čísel nezávisí od predvoleného národného prostredia systému.
Verzia: 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 je statická metóda, ktorá vracia formátovaný String; výsledok sama nevypisuje. Formátovací reťazec kombinuje bežný text so špecifikátormi definovanými triedou Formatter. Argumenty sa odovzdávajú za formátovacím reťazcom ako Object... args.
Preťaženie String.format(String format, Object... args) používa Locale.getDefault(Locale.Category.FORMAT). Variant String.format(Locale l, String format, Object... args) umožňuje zadať Locale výslovne; null znamená, že sa nepoužije lokalizácia. Príklad používa Locale.US, aby bol desatinným oddeľovačom bodka.
Pre bežné konverzie má syntax tvar %[argument_index$][flags][width][.precision]conversion. %s formátuje reťazcovú reprezentáciu argumentu, %d desatinné celé číslo a %.2f číslo s pohyblivou desatinnou čiarkou s dvoma číslicami za desatinným oddeľovačom. %04d nastavuje minimálnu šírku štyroch znakov s doplnením nulami. %2$s vyberie druhý argument. %% vloží znak % bez spotrebovania argumentu; %n vloží oddeľovač riadkov závislý od platformy.
Neplatný formátovací reťazec, nekompatibilný typ alebo chýbajúci povinný argument spôsobí IllegalFormatException. Napríklad %d neprijíma String obsahujúci číslice. Nadbytočné argumenty sa ignorujú a zaobchádzanie s hodnotami null závisí od konverzie. Majte formátovací reťazec pod kontrolou a premenné údaje odovzdávajte ako argumenty.
Prí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ýsledok
Ada | id=0007 | score=12.50 | 80%
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.