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

CKTIS / Python

sys.stdout — o fluxo de saída padrão

sys.stdout é o fluxo de texto do Python para a saída padrão, utilizado por omissão por print(). Permite escrever texto diretamente e esvaziar o buffer; não tem necessariamente de apontar para um terminal.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

import sys
sys.stdout.write(text)
sys.stdout.flush()

sys.stdout é um objeto de fluxo, não uma função. É o destino predefinido de print(). Não o confunda com sys.stderr, para onde o interpretador envia as mensagens de erro. O fluxo pode ser substituído por outro objeto semelhante a um ficheiro, por isso não parta do princípio de que representa sempre um terminal.

sys.stdout.write(text) aceita str, não bytes, e devolve o número de caracteres escritos. Não acrescenta automaticamente uma nova linha: use \n para terminar uma linha. A codificação do texto depende da configuração do fluxo.

Por omissão, sys.stdout usa um buffer por linha durante a utilização interativa e por blocos nos restantes casos. Para desativar o buffer da saída padrão, execute o Python com -u ou atribua o valor 1 à variável de ambiente PYTHONUNBUFFERED. No CPython 3.14, o valor 0 não desativa o buffer. O Python ignora esta variável quando é iniciado com -E ou -I. sys.stdout.flush() esvazia o buffer de escrita. O exemplo faz duas escritas que formam uma linha e, em seguida, esvazia explicitamente o buffer.

Para escrever bytes, pode usar sys.stdout.buffer se esse atributo existir. Um objeto substituto, como io.StringIO, pode não o disponibilizar. Em alguns ambientes sem consola, sys.stdout pode ser None; o código de bibliotecas não deve presumir que está disponível.

Exemplos

import sys

sys.stdout.write("Hello")
sys.stdout.write(" world!\n")
sys.stdout.flush()

Resultado

Hello world!

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes