`complex.md`

99 строк · 7.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.8/c-api/complex.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты комплексных чисел89Объекты комплексных чисел в Python реализованы как два различных типа с точки зрения C API: один – это объект Python, доступный программам Python, а другой – структура C, представляющая фактическое значение комплексного числа. API предоставляет функции для работы с обоими.1011## Комплексные числа как C-структуры1213Обратите внимание, что функции, которые принимают эти структуры как параметры и возвращают их как результаты, делают это *по значению*, а не через разыменование указателей. Это единообразно во всём API.1415**`Py_complex`**1617Структура C, соответствующая части значения объекта комплексного числа Python. Большинство функций для работы с объектами комплексных чисел используют структуры этого типа как входные или выходные значения, в зависимости от ситуации. Она определена как:1819```c20typedef struct {21   double real;22   double imag;23} Py_complex;24```2526#### `Py_complex _Py_c_sum(Py_complex left, Py_complex right)`2728Возвращает сумму двух комплексных чисел, используя C-представление [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).2930#### `Py_complex _Py_c_diff(Py_complex left, Py_complex right)`3132Возвращает разность двух комплексных чисел, используя C-представление [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).3334#### `Py_complex _Py_c_neg(Py_complex complex)`3536Возвращает отрицание комплексного числа *complex*, используя представление C [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).3738#### `Py_complex _Py_c_prod(Py_complex left, Py_complex right)`3940Возвращает произведение двух комплексных чисел, используя C-представление [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).4142#### `Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)`4344Возвращает частное двух комплексных чисел, используя C-представление [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).4546Если *divisor* равен нулю, метод возвращает ноль и устанавливает `errno` в `EDOM`.4748#### `Py_complex _Py_c_pow(Py_complex num, Py_complex exp)`4950Возвращает возведение *num* в степень *exp*, используя C-представление [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).5152Если *num* равен нулю, а *exp* не является положительным действительным числом, метод возвращает ноль и устанавливает `errno` в `EDOM`.5354## Комплексные числа как объекты Python5556**`PyComplexObject`**5758Этот подтип [`PyObject`](https://python-all.ru/3.8/c-api/structures.html#c.PyObject) представляет объект комплексного числа Python.5960**[PyTypeObject](https://python-all.ru/3.8/c-api/type.html#c.PyTypeObject) `PyComplex_Type`**6162Этот экземпляр [`PyTypeObject`](https://python-all.ru/3.8/c-api/type.html#c.PyTypeObject) представляет тип комплексного числа Python. Это тот же объект, что и [`complex`](https://python-all.ru/3.8/library/functions.html#complex) в слое Python.6364#### `int PyComplex_Check(PyObject *p)`6566Возвращает истину, если аргумент является [`PyComplexObject`](https://python-all.ru/3.8/c-api/complex.html#c.PyComplexObject) или подтипом [`PyComplexObject`](https://python-all.ru/3.8/c-api/complex.html#c.PyComplexObject).6768#### `int PyComplex_CheckExact(PyObject *p)`6970Возвращает истину, если аргумент является [`PyComplexObject`](https://python-all.ru/3.8/c-api/complex.html#c.PyComplexObject), но не подтипом [`PyComplexObject`](https://python-all.ru/3.8/c-api/complex.html#c.PyComplexObject).7172#### `PyObject* PyComplex_FromCComplex(Py_complex v)`7374*Возвращаемое значение: новая ссылка.*7576Создаёт новый объект комплексного числа Python из значения C [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex).7778#### `PyObject* PyComplex_FromDoubles(double real, double imag)`7980*Возвращаемое значение: новая ссылка.*8182Возвращает новый объект [`PyComplexObject`](https://python-all.ru/3.8/c-api/complex.html#c.PyComplexObject) из *real* и *imag*.8384#### `double PyComplex_RealAsDouble(PyObject *op)`8586Возвращает вещественную часть *op* как C `double`.8788#### `double PyComplex_ImagAsDouble(PyObject *op)`8990Возвращает мнимую часть *op* как C `double`.9192#### `Py_complex PyComplex_AsCComplex(PyObject *op)`9394Возвращает значение [`Py_complex`](https://python-all.ru/3.8/c-api/complex.html#c.Py_complex) комплексного числа *op*.9596Если *op* не является объектом комплексного числа Python, но имеет метод [`__complex__()`](https://python-all.ru/3.8/reference/datamodel.html#object.__complex__), то этот метод будет сначала вызван для преобразования *op* в объект комплексного числа Python. Если `__complex__()` не определён, то используется [`__float__()`](https://python-all.ru/3.8/reference/datamodel.html#object.__float__). Если `__float__()` не определён, то используется [`__index__()`](https://python-all.ru/3.8/reference/datamodel.html#object.__index__). При неудаче этот метод возвращает `-1.0` в качестве действительного значения.9798Изменено в версии 3.8: Используйте [`__index__()`](https://python-all.ru/3.8/reference/datamodel.html#object.__index__), если доступно.99