CKTIS / Python
str: textová reprezentace objektu
str vytváří řetězec Unicode. Převod čísla na text neprovádí výpočet; převod bajtů na text vyžaduje vědomou volbu kódování.
Verze: Python 3.14
Syntaxe
str()
str(object)
str(object, encoding, errors='strict')str(23) vytváří text "23". Spojení s "5" proto dá "235", nikoli číselný součet. Řetězce jsou neměnné: metody vracející změněný text vytvářejí výsledek, místo aby změnily jednotlivý znak v existujícím řetězci. str() bez argumentů dává prázdný řetězec.
U objektů používá str jejich čitelnou reprezentaci, definovanou pomocí __str__. repr slouží jinému účelu: reprezentaci vhodné pro ladění. Nepředpokládej, že každý řetězec získaný z objektu lze později bezeztrátově převést zpět.
str(b"ok") zobrazuje reprezentaci bajtového objektu včetně označení b, místo aby dekódoval jeho obsah. str(b"ok", "utf-8") dekóduje bajty zadaným kódováním. Neplatné bajty ve výchozím režimu strict vyvolají UnicodeDecodeError; ignorování chyb může ztratit data.
Příklad ukazuje obě cesty odděleně. str neposkytuje escapování HTML, ochranu SQL ani bezpečný formát výměny dat. Pro tyto účely zvol vhodný mechanismus, například parametry dotazu nebo serializaci JSON.
Příklady
print(str(23) + "5")
print(str(b"ok"))
print(str(b"ok", "utf-8"))
try:
str(b"\xff", "utf-8")
except UnicodeDecodeError:
print("UnicodeDecodeError")
Výsledek
235 b'ok' ok UnicodeDecodeError