Что такое функция str в Python?

Функция str в Python используется для преобразования значения в строковый формат.

Пример:

number = 10
text = str(number)
print(text)
# Вывод: "10"

Эта функция полезна для преобразования чисел и других типов данных в строку для последующей обработки или вывода.

Функция str() нужна для приведения к типу данных строка (string):

x = 3.5
print(type(x)) # => <class 'int'>

y = str(3.5)
print(type(y)) # => <class 'str'>

Также у функции есть два необязательных аргумента:

• encoding - указывает кодировку, в которую будет происходить конвертация. По умолчанию используется UTF-8
• errors - сообщение об ошибке, если конвертация закончится неудачей

Функция Python str() используется для преобразования объекта в его строковое представление.

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

Функция str() возвращает:

• печатное строковое представление данного объекта
• строковое представление данного байтового объекта в предоставленной кодировк

Примеры:

# строковое представление 
name = str('Коля')
print(name)
print(type(name))

# строковое представление целого числа
age = str(24)
print(age)
print(type(age))

# строковое представление числовой строки
height = str('175см')
print(height)
print(type(height))

str() превращает значение в строку. Чаще всего так склеивают число с текстом:

age = 25
print("Возраст: " + str(age))  # => Возраст: 25

str — это и название типа строк в Python: type("привет") вернёт <class 'str'>. Сокращение от string — «строка».

Зачем нужен str()

Python не складывает строку с числом:

print("Возраст: " + 25)
# TypeError: can only concatenate str (not "int") to str

str(25) превращает число в строку "25", и склейка работает.

Что возвращает str()

Число в строку и обратно

n = 2026
s = str(n)        # '2026'
print(len(s))     # => 4 — количество цифр
print(s[::-1])    # => '6202' — цифры в обратном порядке
print(int(s))     # => 2026 — снова число

Через str() перебирают отдельные цифры числа: сумма цифр — sum(int(d) for d in str(n)).

f-строки

Числа в тексте короче выводить через f-строку: Python сам переведёт значение в строку.

name = "Анна"
age = 25
print(f"{name}, {age} лет")  # => Анна, 25 лет

str() для своих классов

str(obj) вызывает у объекта метод __str__. Его определяют, чтобы задать, как объект выглядит при печати:

class Point:
    def __init__(self, x, y):
        self.x, self.y = x, y

    def __str__(self):
        return f"({self.x}, {self.y})"

print(Point(2, 3))  # => (2, 3)

print() тоже вызывает str() для каждого аргумента.

Типы данных и строки разбирают в бесплатном курсе «Основы Python», магические методы — на курсе «ООП на Python».