Справочник по функциям Python

str

Преобразует объект в строку.

Python 3.13
str(object='')
str(object=b'', encoding='utf-8', errors='strict')
  • =значение по умолчанию
object
Объект, который нужно представить строкой.
AnyНеобязательный
encoding
Кодировка, если object — байты, например 'utf-8'; с ней байты раскодируются в текст.
strНеобязательный
errors
Что делать с байтами, которые не раскодируются, по умолчанию 'strict' — ошибка.
strНеобязательный
'strict''ignore''replace''backslashreplace''surrogateescape'

Возвращаемое значение

Строка с текстовым представлением объекта; без аргументов — пустая строка.

Примеры

Строка из числа

Python 3.13
text = str(123)
print(text + '4')
print(len(text))
1234
3

Байты с кодировкой и без

Python 3.13
print(str(b'hi'))
print(str(b'hi', 'utf-8'))
b'hi'
hi

Подробности

Для строк str возвращает текст как есть, а repr — с кавычками: str("hi") даёт hi, repr("hi") — 'hi'. Байты без encoding превращаются в свою запись b'...', а с encoding — в раскодированный текст; то же делает bytes.decode. С errors='ignore' нераскодируемые байты пропускаются, с 'replace' заменяются знаком �, а с 'backslashreplace' — записью вида \xff.

Смотрите также

Где изучить