> For the complete documentation index, see [llms.txt](https://bemind.gitbook.io/neural/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bemind.gitbook.io/neural/python/vstroennye-funkcii-python/str.md).

# str()

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

**Назначение**:

* Преобразовать объект в строку.
* Создать новый строковый объект из заданного объекта.

**Возврат**:

* Возвращает строковое представление объекта.

**Описание**:

* Может быть вызвана без аргументов для создания пустой строки.
* Принимает один необязательный аргумент `object` - объект для преобразования в строку.
* Если объект имеет метод `__str__()`, он будет использован для получения строкового представления.
* Для большинства встроенных типов возвращает читаемое представление объекта.

**Примеры**:

1. ***Преобразование чисел в строки***
2. ***Создание строки из объекта***
3. ***Преобразование списка в строку***

{% tabs %}
{% tab title="1." %}

```renpy
print(str(123))  # Выведет: "123"
print(str(3.14))  # Выведет: "3.14"
```

{% endtab %}

{% tab title="2." %}

```python
class Person:
    def __init__(self, name, age):
        self.name = name
        self.age = age
    
    def __str__(self):
        return f"Person(name={self.name}, age={self.age})"

person = Person("Alice", 30)
print(str(person))  # Выведет: "Person(name=Alice, age=30)"
```

{% endtab %}

{% tab title="3." %}

```python
my_list = [1, 2, 3]
print(str(my_list))  # Выведет: "[1, 2, 3]"
```

{% endtab %}
{% endtabs %}

**Использование**:

* Для явного преобразования объектов в строки.
* При форматировании строк, когда требуется строковое представление объекта.
* В функциях, ожидающих строковый аргумент.
* Для создания читаемых представлений объектов при выводе или логировании.

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

Важно отметить, что `str()` отличается от `repr()`. В то время как `str()` предназначена для создания читаемого представления объекта, `repr()` стремится создать более подробное и однозначное представление, которое, по возможности, может быть использовано для воссоздания объекта.

При определении пользовательских классов рекомендуется реализовывать метод `__str__()`, чтобы обеспечить удобное строковое представление объектов этого класса при использовании `str()` или функции `print()`.