Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

System.out.println: praktyczna referencja

System.out.println: praktyczna referencja: PrintStream.println wybiera przeciążenie dla wartości, zapisuje jej tekstową postać, a następnie separator wiersza właściwy platformie; Object przechodzi przez String.valueOf.

Wersja: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Składnia

System.out.println

PrintStream.println wybiera przeciążenie dla wartości, zapisuje jej tekstową postać, a następnie separator wiersza właściwy platformie; Object przechodzi przez String.valueOf.

Używaj println do czytelnego dla człowieka wyjścia wierszowego, gdy znasz docelowy PrintStream i jego kodowanie; do protokołów wybierz jawny format oraz Charset.

PrintStream zwykle zapisuje błąd I/O we fladze checkError zamiast zgłaszać IOException. Równoległe zapisy mogą się przeplatać, a println nie wykonuje escapowania JSON, CSV ani HTML.

println() bez argumentu zapisuje tylko separator wiersza. null przekazany jako String lub Object daje tekst null, a dokładne bajty końca wiersza zależą od platformy.

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Przykłady

public class Main {
    public static void main(String[] args) throws Exception {
        var bytes = new java.io.ByteArrayOutputStream();
        try (var stream = new java.io.PrintStream(bytes, true, java.nio.charset.StandardCharsets.UTF_8)) {
            stream.println("Java");
            stream.println(21);
        }
        String text = bytes.toString(java.nio.charset.StandardCharsets.UTF_8);
        System.out.print(text.replace(System.lineSeparator(), "|"));
    }
}

Wynik

Java|21|

Przykład sprawdza opisywany element w małym, deterministycznym programie i porównuje dokładny standardowy wynik.

Źródła