Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

str: representação textual de um objeto

str cria uma cadeia Unicode. Converter um número em texto não executa cálculos; transformar bytes em texto exige uma escolha consciente da codificação.

Versão: Python 3.14

Sintaxe

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

str(23) produz o texto "23". Juntá-lo a "5" produz, por isso, "235", não uma soma numérica. As cadeias são imutáveis: os métodos que devolvem texto alterado produzem um resultado em vez de modificar um carácter da cadeia existente. str() sem argumentos produz uma cadeia vazia.

Para objetos, str usa a sua representação legível, definida por __str__. repr tem outra finalidade: uma representação útil para depuração. Não assumas que todas as cadeias obtidas a partir de objetos podem ser reconvertidas sem perdas.

str(b"ok") mostra a representação do objeto de bytes, incluindo o marcador b, em vez de descodificar o conteúdo. str(b"ok", "utf-8") descodifica os bytes com a codificação indicada. Bytes inválidos no modo predefinido strict provocam UnicodeDecodeError; ignorar erros pode perder dados.

O exemplo mostra os dois caminhos separadamente. str não faz escape de HTML, não protege SQL nem fornece um formato seguro de intercâmbio. Escolhe um mecanismo apropriado, como parâmetros de consultas ou serialização JSON.

Exemplos

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

Fontes