Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

PrintStream.printf — formatowane wyjście

PrintStream.printf zapisuje dane według łańcucha formatującego, np. do System.out. Pozwala określać sposób prezentacji liczb i tekstu oraz jawnie wybrać ustawienia regionalne.

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

Składnia

public PrintStream printf(String format, Object... args)
public PrintStream printf(Locale l, String format, Object... args)

PrintStream.printf zapisuje sformatowane dane do strumienia, zamiast zwracać tekst. Zwraca ten sam PrintStream, umożliwiając łączenie wywołań. Oba przeciążenia działają jak odpowiadające im wywołania format.

printf(String format, Object... args) używa domyślnych ustawień kategorii Locale.Category.FORMAT. printf(Locale l, String format, Object... args) stosuje podane ustawienia; null jako l wyłącza lokalizację. Nadmiarowe argumenty są ignorowane.

%s formatuje tekstową reprezentację argumentu, %d liczbę całkowitą dziesiętnie, a %.2f liczbę zmiennoprzecinkową z dwiema cyframi po separatorze dziesiętnym. %% wypisuje %, a %n separator wiersza właściwy dla platformy; nie zużywają argumentów. printf nie dodaje końca wiersza automatycznie.

Niepoprawny format, niezgodny typ argumentu lub brak argumentu powoduje IllegalFormatException; null jako format powoduje NullPointerException. Nie przekazuj niezaufanego tekstu jako formatu: użyj stałego "%s" i przekaż tekst jako argument.

Przykłady

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        System.out.printf(Locale.US, "%s: %d | %.2f | 100%%%n", "Result", 3, 12.5);
    }
}

Wynik

Result: 3 | 12.50 | 100%

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

Źródła