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

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

Zdroje