Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

str: representación textual de un objeto

str crea una cadena Unicode. Convertir un número en texto no realiza operaciones aritméticas; convertir bytes en texto exige elegir conscientemente una codificación.

Versión: Python 3.14

Sintaxis

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

str(23) produce el texto "23". Al unirlo con "5" obtienes "235", no una suma numérica. Las cadenas son inmutables: los métodos que devuelven texto modificado producen un resultado en vez de cambiar un carácter de la cadena existente. str() sin argumentos produce una cadena vacía.

Para objetos, str utiliza su representación legible, definida por __str__. repr tiene otra finalidad: una representación útil para depurar. No supongas que cualquier cadena obtenida de un objeto podrá convertirse de nuevo sin pérdidas.

str(b"ok") muestra la representación del objeto de bytes, incluido su marcador b, en lugar de decodificar el contenido. str(b"ok", "utf-8") decodifica los bytes con la codificación indicada. Los bytes inválidos en el modo predeterminado strict provocan UnicodeDecodeError; ignorar errores puede perder datos.

El ejemplo muestra ambos caminos por separado. str no proporciona escape HTML, protección SQL ni un formato seguro de intercambio. Elige mecanismos adecuados, como parámetros de consultas o serialización JSON.

Ejemplos

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

Resultado

235
b'ok'
ok
UnicodeDecodeError

Fuentes