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.