Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

sys.stdout — le flux de sortie standard

sys.stdout est le flux texte de Python destiné à la sortie standard, utilisé par défaut par print(). Il permet d’écrire directement du texte et de vider le tampon ; il ne pointe pas nécessairement vers un terminal.

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

Syntaxe

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

sys.stdout est un objet flux, pas une fonction. C’est la destination par défaut de print(). Ne le confondez pas avec sys.stderr, vers lequel l’interpréteur envoie les messages d’erreur. Le flux peut être remplacé par un autre objet de type fichier ; ne supposez donc pas qu’il représente toujours un terminal.

sys.stdout.write(text) accepte str, et non bytes, et renvoie le nombre de caractères écrits. Il n’ajoute pas automatiquement de nouvelle ligne : utilisez \n pour terminer une ligne. L’encodage du texte dépend de la configuration du flux.

Par défaut, sys.stdout est mis en mémoire tampon par ligne en mode interactif et par blocs dans les autres cas. Pour désactiver la mise en mémoire tampon de la sortie standard, lancez Python avec -u ou définissez la variable d’environnement PYTHONUNBUFFERED sur 1. Dans CPython 3.14, la valeur 0 ne désactive pas la mise en mémoire tampon. Python ignore cette variable lorsqu’il est lancé avec -E ou -I. sys.stdout.flush() vide le tampon d’écriture. L’exemple effectue deux écritures qui forment une seule ligne, puis vide explicitement le tampon.

Pour écrire des octets, vous pouvez utiliser sys.stdout.buffer si cet attribut existe. Un objet de remplacement tel que io.StringIO peut ne pas le fournir. Dans certains environnements sans console, sys.stdout peut valoir None ; le code d’une bibliothèque ne doit pas supposer qu’il est disponible.

Exemples

import sys

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

Résultat

Hello world!

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources