CKTIS / Java
String.format — oblikovanje teksta
String.format stvara tekst iz formatnog niza i argumenata pomoću specifikatora kao što su %s, %d i %.2f. Izričito zadani Locale čini oblikovanje brojeva neovisnim o zadanim regionalnim postavkama okruženja.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversionString.format statička je metoda koja vraća formatirani String; sama ne ispisuje rezultat. Formatni niz kombinira običan tekst sa specifikatorima koje definira Formatter. Argumenti se prosljeđuju nakon formatnog niza kao Object... args.
Preopterećena metoda String.format(String format, Object... args) koristi Locale.getDefault(Locale.Category.FORMAT). Varijanta String.format(Locale l, String format, Object... args) omogućuje izričito zadavanje Locale; null znači da se ne primjenjuje lokalizacija. Primjer upotrebljava Locale.US kako bi decimalni separator bio točka.
Za uobičajene konverzije sintaksa je %[argument_index$][flags][width][.precision]conversion. %s oblikuje tekstualni prikaz argumenta, %d decimalni cijeli broj, a %.2f broj s pomičnim zarezom s dvije znamenke iza decimalnog separatora. %04d postavlja minimalnu širinu od četiri znaka uz popunjavanje nulama. %2$s odabire drugi argument. %% umeće doslovni % bez trošenja argumenta; %n umeće razdjelnik retka ovisan o platformi.
Neispravan formatni niz, nekompatibilan tip ili izostanak potrebnog argumenta uzrokuje IllegalFormatException. Primjerice, %d ne prihvaća String koji sadrži znamenke. Suvišni argumenti zanemaruju se, a obrada vrijednosti null ovisi o konverziji. Zadržite kontrolu nad formatnim nizom, a promjenjive podatke prosljeđujte kao argumente.
Primjeri
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);
}
}Rezultat
Ada | id=0007 | score=12.50 | 80%
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.