Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

str: la rappresentazione testuale di un oggetto

str crea una stringa Unicode. Convertire un numero in testo non esegue calcoli; trasformare byte in testo richiede una scelta consapevole della codifica.

Versione: Python 3.14

Sintassi

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

str(23) produce il testo "23". Unirlo a "5" produce quindi "235", non una somma numerica. Le stringhe sono immutabili: i metodi che restituiscono testo modificato producono un risultato invece di cambiare un singolo carattere della stringa esistente. str() senza argomenti produce una stringa vuota.

Per gli oggetti, str usa la loro rappresentazione leggibile, definita da __str__. repr serve a un altro scopo: una rappresentazione utile per il debug. Non presumere che ogni stringa ricavata da un oggetto possa poi essere riconvertita senza perdite.

str(b"ok") mostra la rappresentazione dell’oggetto di byte, incluso il marcatore b, invece di decodificarne il contenuto. str(b"ok", "utf-8") decodifica i byte con la codifica indicata. Byte non validi nella modalità predefinita strict generano UnicodeDecodeError; ignorare gli errori può perdere dati.

L’esempio mostra separatamente le due modalità. str non fornisce escaping HTML, protezione SQL o un formato sicuro di scambio. Scegli il meccanismo adatto, per esempio parametri delle query o serializzazione JSON.

Esempi

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

Risultato

235
b'ok'
ok
UnicodeDecodeError

Fonti