KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

str: een tekstweergave van een object

str maakt een Unicode-tekenreeks. Een getal naar tekst omzetten voert geen berekening uit; bytes naar tekst omzetten vraagt om een bewuste keuze van tekencodering.

Versie: Python 3.14

Syntax

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

str(23) levert de tekst "23" op. Samenvoegen met "5" geeft daarom "235", geen numerieke som. Tekenreeksen zijn onveranderlijk: methoden die gewijzigde tekst teruggeven maken een resultaat, in plaats van één teken in de bestaande tekenreeks te veranderen. str() zonder argumenten geeft een lege tekenreeks.

Voor objecten gebruikt str hun leesbare weergave, bepaald door __str__. repr heeft een ander doel: een weergave die nuttig is bij het debuggen. Neem niet aan dat iedere uit een object verkregen tekenreeks later verliesloos kan worden teruggezet.

str(b"ok") toont de weergave van het bytes-object, inclusief de markering b, in plaats van de inhoud te decoderen. str(b"ok", "utf-8") decodeert bytes met de opgegeven codering. Ongeldige bytes veroorzaken in de standaardmodus strict een UnicodeDecodeError; fouten negeren kan gegevens verliezen.

Het voorbeeld toont beide routes afzonderlijk. str levert geen HTML-escaping, SQL-bescherming of veilig uitwisselingsformaat. Kies daarvoor een geschikt mechanisme, zoals queryparameters of JSON-serialisatie.

Voorbeelden

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

Resultaat

235
b'ok'
ok
UnicodeDecodeError

Bronnen