WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

str: die Textdarstellung eines Objekts

str erzeugt eine Unicode-Zeichenkette. Eine Zahl in Text umzuwandeln führt keine Rechnung aus; für Bytes ist eine bewusste Wahl der Zeichencodierung erforderlich.

Version: Python 3.14

Syntax

str()
str(object)
str(object, encoding, errors='strict')

str(23) erzeugt den Text "23". Zusammenfügen mit "5" ergibt deshalb "235" und keine Zahlensumme. Zeichenketten sind unveränderlich: Methoden, die geänderten Text zurückgeben, erzeugen ein Ergebnis, statt einzelne Zeichen der vorhandenen Zeichenkette zu ändern. str() ohne Argumente ergibt eine leere Zeichenkette.

Für Objekte verwendet str die lesbare Darstellung, die durch __str__ festgelegt wird. repr verfolgt einen anderen Zweck: eine zum Debuggen geeignete Darstellung. Gehe nicht davon aus, dass sich jede aus einem Objekt gewonnene Zeichenkette später verlustfrei zurückverwandeln lässt.

str(b"ok") zeigt die Darstellung des Byte-Objekts einschließlich der Markierung b, statt seinen Inhalt zu decodieren. str(b"ok", "utf-8") decodiert die Bytes mit der angegebenen Codierung. Ungültige Bytes lösen im voreingestellten Modus strict einen UnicodeDecodeError aus. Das Ignorieren von Fehlern kann Daten verlieren.

Das Beispiel zeigt beide Wege getrennt. str bietet weder HTML-Escaping noch SQL-Schutz oder ein sicheres Austauschformat. Verwende dafür einen passenden Mechanismus, etwa Abfrageparameter oder JSON-Serialisierung.

Beispiele

print(str(23) + "5")
print(str(b"ok"))
print(str(b"ok", "utf-8"))
try:
    str(b"\xff", "utf-8")
except UnicodeDecodeError:
    print("UnicodeDecodeError")

Ergebnis

235
b'ok'
ok
UnicodeDecodeError

Quellen