> **Источник:** https://python-all.ru/3.3/c-api/float.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Объекты с плавающей запятой

**`PyFloatObject`**

Этот подтип [`PyObject`](https://python-all.ru/3.3/c-api/structures.html#PyObject) представляет объект числа с плавающей точкой Python.

**[PyTypeObject](https://python-all.ru/3.3/c-api/type.html#PyTypeObject) `PyFloat_Type`**

Этот экземпляр [`PyTypeObject`](https://python-all.ru/3.3/c-api/type.html#PyTypeObject) представляет тип чисел с плавающей точкой Python. Это тот же объект, что и [`float`](https://python-all.ru/3.3/library/functions.html#float) в слое Python.

#### `int PyFloat_Check(PyObject *p)`

Возвращает истину, если аргумент является [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject) или подтипом [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject).

#### `int PyFloat_CheckExact(PyObject *p)`

Возвращает истину, если аргумент является [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject), но не подтипом [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject).

#### `PyObject* PyFloat_FromString(PyObject *str)`

*Возвращаемое значение: новая ссылка.*

Создаёт объект [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject) на основе строкового значения в *str* или *NULL* в случае ошибки.

#### `PyObject* PyFloat_FromDouble(double v)`

*Возвращаемое значение: новая ссылка.*

Создаёт объект [`PyFloatObject`](https://python-all.ru/3.3/c-api/float.html#PyFloatObject) из *v* или *NULL* в случае ошибки.

#### `double PyFloat_AsDouble(PyObject *pyfloat)`

Возвращает представление содержимого *pyfloat* в виде C `double`. Если *pyfloat* не является объектом числа с плавающей точкой Python, но имеет метод [`__float__()`](https://python-all.ru/3.3/reference/datamodel.html#object.__float__), то этот метод сначала вызывается для преобразования *pyfloat* в float. Этот метод возвращает `-1.0` в случае ошибки, поэтому следует вызвать [`PyErr_Occurred()`](https://python-all.ru/3.3/c-api/exceptions.html#PyErr_Occurred) для проверки ошибок.

#### `double PyFloat_AS_DOUBLE(PyObject *pyfloat)`

Возвращает представление содержимого *pyfloat* в виде C `double`, но без проверки ошибок.

#### `PyObject* PyFloat_GetInfo(void)`

Возвращает экземпляр structseq, содержащий информацию о точности, минимальном и максимальном значениях числа с плавающей точкой. Это тонкая обёртка вокруг заголовочного файла `float.h`.

#### `double PyFloat_GetMax()`

Возвращает максимальное представимое конечное число с плавающей запятой *DBL\_MAX* в виде C `double`.

#### `double PyFloat_GetMin()`

Возвращает минимальное нормализованное положительное число с плавающей запятой *DBL\_MIN* в виде C `double`.

#### `int PyFloat_ClearFreeList()`

Очищает список свободных float. Возвращает количество элементов, которые не удалось освободить.