CKTIS / Python
`sys.stdout` e o módulo `sys`: escolher um fluxo de saída
Importa `sys` para passar explicitamente o fluxo atual da saída padrão a `print()`, ou escolhe outro fluxo de texto para uma única chamada.
Versão: Python 3.12
Sintaxe
import sys
print(value, file=sys.stdout)
print(value, file=text_stream)
sys.stdout.write(text)sys é um módulo incorporado que dá acesso a definições e funções do interpretador. import sys associa o nome sys ao módulo no âmbito atual. O ponto em sys.stdout dá acesso ao atributo stdout, que contém o fluxo de texto atual da saída padrão. sys.stderr é um fluxo separado para mensagens de diagnóstico.
Se omitires file ou passares file=None, print() usa o sys.stdout atual. print(value, file=sys.stdout) seleciona explicitamente esse mesmo fluxo, mas não força a apresentação no terminal: a saída padrão pode estar redirecionada para um ficheiro ou um pipe. Passar outro fluxo altera o destino apenas nessa chamada, sem substituir sys.stdout.
Passa a file um objeto cujo método write() aceite str, não um caminho nem um ficheiro binário. sys.stdout.write(text) escreve texto sem acrescentar uma mudança de linha; print() acrescenta uma por omissão. Usa flush=True se quiseres que print() esvazie imediatamente o buffer do fluxo.
Não feches sys.stdout só porque o utilizaste. O ambiente pode substituí-lo por outro objeto e, em algumas configurações, o seu valor pode ser None. Não assumas que é sempre possível chamar diretamente sys.stdout.write().
Exemplos
import sys
from io import StringIO
print("Default")
print("Explicit", file=sys.stdout)
with StringIO() as capture:
print("Captured", file=capture)
print(capture.getvalue(), end="", file=sys.stdout)
Resultado
Default Explicit Captured
`Default` e `Explicit` seguem para a mesma saída padrão. `Captured` é primeiro escrito em memória (`StringIO`) e só aparece na saída padrão quando se escreve o resultado de `getvalue()`. `end=""` evita acrescentar uma segunda mudança de linha.
Lições relacionadas
- Python · Lição 24 · Intermédio · Versão: 3