Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

sys.stdout — standardowy strumień wyjściowy

sys.stdout to tekstowy strumień standardowego wyjścia Pythona, używany domyślnie przez print(). Pozwala bezpośrednio zapisywać tekst i opróżniać bufor; nie musi wskazywać terminala.

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

Składnia

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

sys.stdout jest obiektem strumienia, a nie funkcją. Stanowi domyślne wyjście dla print(). Nie należy go mylić z sys.stderr, do którego interpreter kieruje komunikaty błędów. Strumień może zostać zastąpiony innym obiektem plikopodobnym, więc nie zakładaj, że zawsze reprezentuje terminal.

sys.stdout.write(text) przyjmuje str, nie bytes, i zwraca liczbę zapisanych znaków. Nie dopisuje automatycznie znaku nowego wiersza: użyj \n, jeśli chcesz zakończyć wiersz. Kodowanie tekstu zależy od konfiguracji strumienia.

Domyślnie standardowy sys.stdout jest buforowany wierszowo podczas pracy interaktywnej, a poza nią — blokowo. Aby wyłączyć buforowanie standardowego wyjścia, uruchom Pythona z opcją -u lub ustaw zmienną środowiskową PYTHONUNBUFFERED na 1. W CPythonie 3.14 wartość 0 nie wyłącza buforowania. Python ignoruje tę zmienną po uruchomieniu z opcją -E lub -I. sys.stdout.flush() opróżnia bufor zapisu. Przykład wykonuje dwa zapisy tworzące jeden wiersz, po czym jawnie opróżnia bufor.

Do zapisu bajtów można użyć sys.stdout.buffer, jeśli ten atrybut istnieje. Obiekt zastępczy, taki jak io.StringIO, może go nie udostępniać. W niektórych środowiskach bez konsoli sys.stdout może mieć wartość None; kod biblioteczny nie powinien zakładać jego dostępności.

Przykłady

import sys

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

Wynik

Hello world!

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła