str() Construção de string
Última atualização: 2026-09-22
str() Construção de string
str() converte o objeto em string; sem argumentos retorna string vazia.
| Categoria | Funções internas |
|---|---|
| Tipo | Função interna |
| Versão do Python | all |
📝 Sintaxe
str(object='')
str(object=b'', encoding='utf-8', errors='strict')
⚙️ Parâmetros
| object Opcional | The object to convert; omitted returns ''.(Padrão:'') |
|---|---|
| encoding Opcional | Encoding used when decoding bytes.(Padrão:'utf-8') |
| errors Opcional | Error handling for decoding (strict/ignore/replace, etc.).(Padrão:'strict') |
Retorno:The string form of the object; bytes are decoded using the given encoding.
💥 Exceções
UnicodeDecodeError— Raised when bytes cannot be decoded with the given encoding.TypeError— Raised when encoding is given with a non-bytes object.
▶ Exemplo
Edite o código, clique em Executar e veja o resultado no painel de saída:
Saída:
42
[1, 2]
中
🏷️ Funções internas relacionadas
💡 Casos relacionados
Mais estudos de caso em breve — aguarde.
❓ Perguntas frequentes
QO que str(42) e str([1, 2]) retornam?
ARetornam '42' e '[1, 2]' — str() converte qualquer objeto em uma string legível.
QO que str() retorna sem argumentos?
ARetorna a string vazia ''.
QO que str(b'\xe4\xb8\xad', encoding='utf-8') retorna?
ARetorna '中'. Um objeto bytes precisa de um encoding para ser decodificado em string; sem encoding você obtém apenas uma forma literal como "b'\\xe4\\xb8\\xad'".
QQual é a diferença entre str() e repr()?
Astr() é para humanos (usado por print por padrão), repr() é para desenvolvedores e visa ser reconstruível; ex.: str('a') é a enquanto repr('a') é "'a'".