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

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

Fontes