CKTIS / Python
str: tekstowa reprezentacja obiektu
str tworzy napis Unicode. Zamiana liczby na napis nie zmienia jej w inną liczbę, a zamiana bajtów na tekst wymaga świadomego wyboru kodowania.
Wersja: Python 3.14
Składnia
str()
str(object)
str(object, encoding, errors='strict')str(23) daje tekst "23". Dlatego połączenie go z "5" daje "235", nie sumę liczb. Napisy są niezmienne: metody zwracające zmieniony tekst tworzą wynik, a nie modyfikują pojedynczego znaku w istniejącym napisie. str() bez argumentów daje pusty napis.
Dla obiektów str korzysta z ich reprezentacji przeznaczonej do czytania, określanej przez __str__. repr służy innemu celowi: reprezentacji przydatnej do diagnozowania. Nie zakładaj, że każdy napis uzyskany z obiektu można później bezstratnie zamienić z powrotem.
str(b"ok") pokazuje reprezentację obiektu bajtowego, razem z oznaczeniem b, zamiast dekodować jego zawartość. str(b"ok", "utf-8") dekoduje bajty według wskazanego kodowania. Błędne bajty przy domyślnym trybie strict powodują UnicodeDecodeError; ignorowanie błędów może zgubić dane.
Przykład pokazuje obie drogi osobno. str nie zapewnia escapowania HTML, ochrony SQL ani bezpiecznego formatu wymiany danych. Do takich zastosowań dobieraj właściwy mechanizm, np. parametry zapytania lub serializację JSON.
Przykłady
print(str(23) + "5")
print(str(b"ok"))
print(str(b"ok", "utf-8"))
try:
str(b"\xff", "utf-8")
except UnicodeDecodeError:
print("UnicodeDecodeError")
Wynik
235 b'ok' ok UnicodeDecodeError