`float.md`

201 строк · 14.7 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.13/c-api/float.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты с плавающей запятой89#### `type PyFloatObject`1011Этот подтип [`PyObject`](https://python-all.ru/3.13/c-api/structures.html#c.PyObject) представляет объект с плавающей запятой в Python.1213#### `PyTypeObject PyFloat_Type`1415*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*1617Этот экземпляр [`PyTypeObject`](https://python-all.ru/3.13/c-api/type.html#c.PyTypeObject) представляет тип с плавающей запятой в Python. Это тот же объект, что и [`float`](https://python-all.ru/3.13/library/functions.html#float) на уровне Python.1819#### `int PyFloat_Check(PyObject *p)`2021Возвращает истину, если аргумент является [`PyFloatObject`](https://python-all.ru/3.13/c-api/float.html#c.PyFloatObject) или подтипом `PyFloatObject`. Эта функция всегда завершается успешно.2223#### `int PyFloat_CheckExact(PyObject *p)`2425Возвращает истину, если аргумент является [`PyFloatObject`](https://python-all.ru/3.13/c-api/float.html#c.PyFloatObject), но не подтипом `PyFloatObject`. Эта функция всегда завершается успешно.2627#### `PyObject *PyFloat_FromString(PyObject *str)`2829*Возвращаемое значение: новая ссылка.*3031*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*3233Создаёт объект [`PyFloatObject`](https://python-all.ru/3.13/c-api/float.html#c.PyFloatObject) на основе строкового значения *str* или `NULL` в случае ошибки.3435#### `PyObject *PyFloat_FromDouble(double v)`3637*Возвращаемое значение: новая ссылка.*3839*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*4041Создаёт объект [`PyFloatObject`](https://python-all.ru/3.13/c-api/float.html#c.PyFloatObject) из *v* или `NULL` в случае ошибки.4243#### `double PyFloat_AsDouble(PyObject *pyfloat)`4445*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*4647Возвращает представление содержимого *pyfloat* в виде C double. Если *pyfloat* не является объектом с плавающей запятой Python, но имеет метод [`__float__()`](https://python-all.ru/3.13/reference/datamodel.html#object.__float__), то сначала будет вызван этот метод для преобразования *pyfloat* в число с плавающей запятой. Если `__float__()` не определён, то используется [`__index__()`](https://python-all.ru/3.13/reference/datamodel.html#object.__index__). Этот метод возвращает `-1.0` при неудаче, поэтому следует вызывать [`PyErr_Occurred()`](https://python-all.ru/3.13/c-api/exceptions.html#c.PyErr_Occurred) для проверки ошибок.4849Изменено в версии 3.8: Используйте [`__index__()`](https://python-all.ru/3.13/reference/datamodel.html#object.__index__), если доступно.5051#### `double PyFloat_AS_DOUBLE(PyObject *pyfloat)`5253Возвращает представление содержимого *pyfloat* в виде C double, но без проверки ошибок.5455#### `PyObject *PyFloat_GetInfo(void)`5657*Возвращаемое значение: новая ссылка.*5859*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*6061Возвращает экземпляр structseq, содержащий информацию о точности, минимальном и максимальном значениях числа с плавающей запятой. Это тонкая обёртка вокруг заголовочного файла `float.h`.6263#### `double PyFloat_GetMax()`6465*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*6667Возвращает максимальное представимое конечное число с плавающей запятой *DBL\_MAX* в виде C double.6869#### `double PyFloat_GetMin()`7071*Часть [Stable ABI](https://python-all.ru/3.13/c-api/stable.html#stable).*7273Возвращает минимальное нормализованное положительное число с плавающей запятой *DBL\_MIN* в виде C double.7475#### `Py_INFINITY`7677Этот макрос раскрывается в константное выражение типа double, представляющее положительную бесконечность.7879На большинстве платформ он эквивалентен макросу `INFINITY` из заголовочного файла `<math.h>` стандарта C11.8081#### `Py_NAN`8283Этот макрос раскрывается в константное выражение типа double, представляющее тихое нечисло (qNaN).8485На большинстве платформ он эквивалентен макросу `NAN` из заголовочного файла `<math.h>` стандарта C11.8687#### `Py_HUGE_VAL`8889Эквивалентно `INFINITY`.9091Устарело с версии 3.14: Макрос [мягко устарел](https://python-all.ru/3.13/glossary.html#term-soft-deprecated).9293#### `Py_MATH_E`9495Определение (точное для типа double) константы [`math.e`](https://python-all.ru/3.13/library/math.html#math.e).9697#### `Py_MATH_El`9899Определение константы [`e`](https://python-all.ru/3.13/library/math.html#math.e) с высокой точностью (long double).100101#### `Py_MATH_PI`102103Определение (точное для типа double) константы [`math.pi`](https://python-all.ru/3.13/library/math.html#math.pi).104105#### `Py_MATH_PIl`106107Определение константы [`pi`](https://python-all.ru/3.13/library/math.html#math.pi) с высокой точностью (long double).108109#### `Py_MATH_TAU`110111Определение (точное для типа double) константы [`math.tau`](https://python-all.ru/3.13/library/math.html#math.tau).112113Добавлено в версии 3.6.114115#### `Py_RETURN_NAN`116117Возвращает [`math.nan`](https://python-all.ru/3.13/library/math.html#math.nan) из функции.118119На большинстве платформ это эквивалентно `return PyFloat_FromDouble(NAN)`.120121#### `Py_RETURN_INF(sign)`122123Возвращает [`math.inf`](https://python-all.ru/3.13/library/math.html#math.inf) или `-math.inf` из функции, в зависимости от знака *sign*.124125На большинстве платформ это эквивалентно следующему:126127```c128return PyFloat_FromDouble(copysign(INFINITY, sign));129```130131#### `Py_IS_FINITE(X)`132133Возвращает `1`, если переданное число с плавающей запятой *X* конечно, то есть является нормальным, субнормальным или нулём, но не бесконечностью или NaN. В противном случае возвращает `0`.134135Устарело с версии 3.14: Макрос [мягко устарел](https://python-all.ru/3.13/glossary.html#term-soft-deprecated). Используйте `isfinite`.136137#### `Py_IS_INFINITY(X)`138139Возвращает `1`, если переданное число с плавающей запятой *X* является положительной или отрицательной бесконечностью. В противном случае возвращает `0`.140141Устарело с версии 3.14: Макрос [мягко устарел](https://python-all.ru/3.13/glossary.html#term-soft-deprecated). Используйте `isinf`.142143#### `Py_IS_NAN(X)`144145Возвращает `1`, если переданное число с плавающей запятой *X* является не-числом (NaN). В противном случае возвращает `0`.146147Устарело с версии 3.14: Макрос [мягко устарел](https://python-all.ru/3.13/glossary.html#term-soft-deprecated). Используйте `isnan`.148149## Функции упаковки и распаковки150151Функции pack и unpack предоставляют эффективный независимый от платформы способ хранения чисел с плавающей запятой в виде строк байтов. Процедуры Pack создают строку байтов из C double, а процедуры Unpack создают C double из такой строки байтов. Суффикс (2, 4 или 8) задает количество байтов в строке байтов.152153На платформах, которые, как считается, используют форматы IEEE 754, эти функции работают путем копирования битов. На других платформах 2-байтовый формат идентичен формату IEEE 754 binary16 (половинная точность), 4-байтовый формат (32-битный) идентичен формату IEEE 754 binary32 (одинарная точность), а 8-байтовый формат – формату IEEE 754 binary64 (двойная точность), хотя упаковка INF и NaN (если такие существуют на платформе) обрабатывается некорректно, и попытка распаковать строку байтов, содержащую IEEE INF или NaN, вызовет исключение.154155На не-IEEE платформах с большей точностью или большим динамическим диапазоном, чем поддерживает IEEE 754, не все значения можно упаковать; на не-IEEE платформах с меньшей точностью или меньшим динамическим диапазоном не все значения можно распаковать. Что происходит в таких случаях, отчасти случайно (увы).156157Добавлено в версии 3.12.158159### Функции упаковки160161Функции упаковки записывают 2, 4 или 8 байт, начиная с *p*. *le* – это аргумент типа int; ненулевое значение означает, что строку байт нужно в формате little-endian (порядок от младшего к старшему: экспонента последней, на `p+1`, `p+3` или `p+6` `p+7`), ноль – формат big-endian (экспонента первой, на *p*). Константу `PY_BIG_ENDIAN` можно использовать для выбора нативного порядка байт: она равна `1` на процессоре с big endian и `0` на процессоре с little endian.162163Возвращаемое значение: `0`, если всё в порядке, `-1`, если произошла ошибка (при этом устанавливается исключение, скорее всего [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError)).164165На платформах, не поддерживающих IEEE, есть две проблемы:166167- Результат этой операции не определён, если *x* является NaN или бесконечностью.168- `-0.0` и `+0.0` дают одну и ту же строку байт.169170#### `int PyFloat_Pack2(double x, char *p, int le)`171172Упаковывает C double в формат IEEE 754 binary16 (половинная точность).173174#### `int PyFloat_Pack4(double x, char *p, int le)`175176Упаковывает C double в формат IEEE 754 binary32 (одинарная точность).177178#### `int PyFloat_Pack8(double x, char *p, int le)`179180Упаковывает C double в формат IEEE 754 binary64 (двойная точность).181182### Функции распаковки183184Функции распаковки читают 2, 4 или 8 байт, начиная с *p*. *le* – это аргумент типа int; он не равен нулю, если строка байт имеет формат little-endian (экспонента последняя, на позициях `p+1`, `p+3`, `p+6` и `p+7`), и равен нулю для big-endian (экспонента первая, на позиции *p*). Константу `PY_BIG_ENDIAN` можно использовать для выбора порядка, соответствующего архитектуре: она равна `1` на процессоре с big-endian, или `0` на процессоре с little-endian.185186Возвращаемое значение: распакованное число double. В случае ошибки возвращается `-1.0`, а [`PyErr_Occurred()`](https://python-all.ru/3.13/c-api/exceptions.html#c.PyErr_Occurred) становится истинным (при этом устанавливается исключение, скорее всего [`OverflowError`](https://python-all.ru/3.13/library/exceptions.html#OverflowError)).187188Обратите внимание: на платформе, не поддерживающей IEEE, эта функция откажется распаковывать строку байт, которая представляет NaN или бесконечность.189190#### `double PyFloat_Unpack2(const char *p, int le)`191192Распаковывает формат IEEE 754 binary16 (половинная точность) в C double.193194#### `double PyFloat_Unpack4(const char *p, int le)`195196Распаковывает формат IEEE 754 binary32 (одинарная точность) в C double.197198#### `double PyFloat_Unpack8(const char *p, int le)`199200Распаковывает формат IEEE 754 binary64 (двойная точность) в C double.201