Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

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

Zdroje