Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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]conversion

String.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.

Viri