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