Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

sys.stdout — standardní výstupní proud

sys.stdout je textový proud Pythonu pro standardní výstup, který ve výchozím nastavení používá print(). Umožňuje přímý zápis textu a vyprázdnění bufferu; nemusí přitom ukazovat na terminál.

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

Syntaxe

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

sys.stdout je objekt proudu, nikoli funkce. Je výchozím cílem pro print(). Nezaměňujte ho s sys.stderr, kam interpret posílá chybové zprávy. Proud lze nahradit jiným objektem podobným souboru, proto nepředpokládejte, že vždy představuje terminál.

sys.stdout.write(text) přijímá str, nikoli bytes, a vrací počet zapsaných znaků. Automaticky nepřidává nový řádek: k ukončení řádku použijte \n. Kódování textu závisí na konfiguraci proudu.

Ve výchozím nastavení se sys.stdout při interaktivním použití bufferuje po řádcích, jinak po blocích. Chcete-li bufferování standardního výstupu vypnout, spusťte Python s volbou -u nebo nastavte proměnnou prostředí PYTHONUNBUFFERED na 1. V CPythonu 3.14 hodnota 0 bufferování nevypíná. Python tuto proměnnou při spuštění s volbou -E nebo -I ignoruje. sys.stdout.flush() vyprázdní zápisový buffer. Příklad provede dva zápisy, které vytvoří jeden řádek, a poté buffer výslovně vyprázdní.

K zápisu bajtů můžete použít sys.stdout.buffer, pokud tento atribut existuje. Náhradní objekt, například io.StringIO, ho nemusí poskytovat. V některých prostředích bez konzole může mít sys.stdout hodnotu None; kód knihovny by neměl předpokládat, že je dostupný.

Příklady

import sys

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

Výsledek

Hello world!

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje