CKTIS / Java
String.format — oblikovanje besedila
String.format ustvari besedilo iz oblikovnega niza in argumentov s specifikatorji, kot so %s, %d in %.2f. Izrecno podani Locale poskrbi, da oblikovanje števil ni odvisno od privzetih območnih nastavitev okolja.
Različica: 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 je statična metoda, ki vrne oblikovan String; rezultata ne izpiše sama. Oblikovni niz združuje navadno besedilo s specifikatorji, ki jih določa Formatter. Argumenti sledijo oblikovnemu nizu in se podajo kot Object... args.
Preobremenitev String.format(String format, Object... args) uporablja Locale.getDefault(Locale.Category.FORMAT). Različica String.format(Locale l, String format, Object... args) omogoča izrecno določitev Locale; null pomeni, da lokalizacija ni uporabljena. Primer uporablja Locale.US, zato je decimalno ločilo pika.
Za običajne pretvorbe je sintaksa %[argument_index$][flags][width][.precision]conversion. %s oblikuje besedilno predstavitev argumenta, %d decimalno celo število, %.2f pa število s plavajočo vejico z dvema števkama za decimalnim ločilom. %04d določi najmanjšo širino štirih znakov in dopolnjevanje z ničlami. %2$s izbere drugi argument. %% vstavi dobesedni %, ne da bi porabil argument; %n vstavi ločilo vrstic, odvisno od platforme.
Neveljaven oblikovni niz, nezdružljiv tip ali manjkajoč zahtevan argument povzroči IllegalFormatException. Na primer, %d ne sprejme String z števkami. Odvečni argumenti so prezrti, obravnava vrednosti null pa je odvisna od pretvorbe. Oblikovni niz imejte pod nadzorom, spremenljive podatke pa podajte kot argumente.
Primeri
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%
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.