Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

String.format — formatowanie tekstu

String.format tworzy tekst z szablonu i argumentów, używając specyfikatorów takich jak %s, %d i %.2f. Jawne Locale pozwala uniezależnić format liczb od domyślnych ustawień środowiska.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversion

String.format jest metodą statyczną zwracającą sformatowany String; sama nie wypisuje wyniku. Szablon łączy zwykły tekst ze specyfikatorami opisanymi przez Formatter. Argumenty przekazuje się po szablonie jako Object... args.

Przeciążenie String.format(String format, Object... args) korzysta z Locale.getDefault(Locale.Category.FORMAT). Wariant String.format(Locale l, String format, Object... args) pozwala jawnie określić ustawienia regionalne; null oznacza brak lokalizacji. Przykład używa Locale.US, aby separatorem dziesiętnym była kropka.

Dla typowych konwersji składnia to %[argument_index$][flags][width][.precision]conversion. %s formatuje tekstową reprezentację argumentu, %d liczbę całkowitą w zapisie dziesiętnym, a %.2f liczbę zmiennoprzecinkową z dwiema cyframi po separatorze. %04d ustala minimalną szerokość czterech znaków i uzupełnianie zerami. %2$s wskazuje drugi argument. %% wstawia znak % bez zużywania argumentu; %n wstawia separator wiersza zależny od platformy.

Niepoprawny szablon, niezgodny typ lub brak wymaganego argumentu powoduje IllegalFormatException. Na przykład %d nie przyjmuje String zawierającego cyfry. Nadmiarowe argumenty są ignorowane, a obsługa null jako wartości zależy od konwersji. Utrzymuj kontrolę nad szablonem, a zmienne dane przekazuj jako argumenty.

Przykłady

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);
    }
}

Wynik

Ada | id=0007 | score=12.50 | 80%

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła