Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

PrintStream.printf — formátovaný výstup

PrintStream.printf zapisuje data podle formátovacího řetězce, například do System.out. Umožňuje určit způsob zobrazení čísel a textu a výslovně zvolit místní nastavení.

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

Syntaxe

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

PrintStream.printf zapisuje formátovaná data do proudu, místo aby vracela text. Vrací stejný PrintStream, takže lze volání řetězit. Obě přetížení se chovají jako odpovídající volání format.

printf(String format, Object... args) používá výchozí nastavení Locale.Category.FORMAT. printf(Locale l, String format, Object... args) použije zadané místní nastavení; předání null jako l lokalizaci vypne. Přebytečné argumenty se ignorují.

%s formátuje textovou reprezentaci argumentu, %d formátuje celé číslo v desítkové soustavě a %.2f formátuje číslo s plovoucí desetinnou čárkou se dvěma číslicemi za desetinným oddělovačem. %% vypíše % a %n vypíše oddělovač řádků specifický pro platformu; ani jeden nespotřebuje argument. printf automaticky nepřidává konec řádku.

Neplatný formát, nekompatibilní typ argumentu nebo chybějící argument způsobí IllegalFormatException; hodnota null pro format způsobí NullPointerException. Nepředávejte nedůvěryhodný text jako formát: použijte pevný formát "%s" a text předejte jako argument.

Příklady

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

Výsledek

Result: 3 | 12.50 | 100%

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje