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

---

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

**`PyFloatObject`**

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

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

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

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

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

Изменено в версии 2.2: Теперь допускаются подтипы.

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

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

Новое в версии 2.2.

#### `PyObject* PyFloat_FromString(PyObject *str, char **pend)`

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

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

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

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

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

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

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

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

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

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

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

Новое в версии 2.6.

#### `double PyFloat_GetMax()`

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

Новое в версии 2.6.

#### `double PyFloat_GetMin()`

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

Новое в версии 2.6.

#### `int PyFloat_ClearFreeList()`

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

Новое в версии 2.6.

#### `void PyFloat_AsString(char *buf, PyFloatObject *v)`

Преобразует аргумент *v* в строку, используя те же правила, что и [`str()`](https://python-all.ru/2.7/library/functions.html#str). Длина *buf* должна быть не менее 100.

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

Устарело с версии 2.7: Вместо этого используйте `PyObject_Str()` или `PyOS_double_to_string()`.

#### `void PyFloat_AsReprString(char *buf, PyFloatObject *v)`

То же, что PyFloat\_AsString, но использует те же правила, что и [`repr()`](https://python-all.ru/2.7/library/functions.html#repr). Длина *buf* должна быть не менее 100.

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

Устарело с версии 2.7: Вместо этого используйте `PyObject_Repr()` или `PyOS_double_to_string()`.