Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

System.out.println: referência prática

System.out.println: referência prática: PrintStream.println escolhe a sobrecarga correspondente ao valor, escreve a sua representação textual e depois o separador de linha da plataforma; Object é convertido por String.valueOf.

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

Sintaxe

System.out.println

PrintStream.println escolhe a sobrecarga correspondente ao valor, escreve a sua representação textual e depois o separador de linha da plataforma; Object é convertido por String.valueOf.

Usa println para saída por linhas destinada a pessoas quando conheces o PrintStream e a codificação; um protocolo exige formato e Charset explícitos.

PrintStream regista normalmente falhas de E/S no estado consultado por checkError em vez de lançar IOException. Escritas concorrentes podem intercalar-se e println não escapa JSON, CSV nem HTML.

println() sem argumento escreve apenas o separador de linha. Um String ou Object null produz o texto null; os bytes de fim de linha dependem da plataforma.

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Exemplos

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(), "|"));
    }
}

Resultado

Java|21|

O exemplo exercita o elemento documentado num programa pequeno e determinístico e compara exatamente a saída padrão.

Fontes