Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

sys.stdout — il flusso di output standard

sys.stdout è il flusso di testo di Python per l’output standard, usato per impostazione predefinita da print(). Consente di scrivere testo direttamente e svuotare il buffer; non è detto che punti a un terminale.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

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

sys.stdout è un oggetto flusso, non una funzione. È la destinazione predefinita di print(). Non confonderlo con sys.stderr, a cui l’interprete invia i messaggi di errore. Il flusso può essere sostituito con un altro oggetto simile a un file, quindi non dare per scontato che rappresenti sempre un terminale.

sys.stdout.write(text) accetta str, non bytes, e restituisce il numero di caratteri scritti. Non aggiunge automaticamente una nuova riga: usa \n per terminare una riga. La codifica del testo dipende dalla configurazione del flusso.

Per impostazione predefinita, sys.stdout è bufferizzato per riga durante l’uso interattivo e a blocchi negli altri casi. Per disattivare il buffering dell’output standard, avvia Python con -u oppure imposta la variabile d’ambiente PYTHONUNBUFFERED a 1. In CPython 3.14, il valore 0 non disattiva il buffering. Python ignora questa variabile quando viene avviato con -E o -I. sys.stdout.flush() svuota il buffer di scrittura. L’esempio esegue due scritture che formano una riga, quindi svuota esplicitamente il buffer.

Per scrivere byte, puoi usare sys.stdout.buffer se questo attributo esiste. Un oggetto sostitutivo come io.StringIO potrebbe non fornirlo. In alcuni ambienti senza console, sys.stdout può essere None; il codice di una libreria non dovrebbe presumere che sia disponibile.

Esempi

import sys

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

Risultato

Hello world!

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti