`complex.md`

173 строк · 7.8 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.1/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](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_sum`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *right*)**2728Возвращает сумму двух комплексных чисел, используя представление C2930[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)3132.3334**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_diff`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *right*)**3536Возвращает разность двух комплексных чисел, используя представление C3738[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)3940.4142**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_neg`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *complex*)**4344Возвращает отрицание комплексного числа4546*complex*4748, используя представление C4950[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)5152.5354**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_prod`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *right*)**5556Возвращает произведение двух комплексных чисел, используя представление C5758[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)5960.6162**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_quot`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *dividend*, [Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *divisor*)**6364Возвращает частное двух комплексных чисел, используя представление C6566[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)6768.6970**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `_Py_c_pow`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *num*, [Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *exp*)**7172Возвращает возведение7374*num*7576в степень7778*exp*7980, используя представление C8182[`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex)8384.8586## Комплексные числа как объекты Python8788**`PyComplexObject`**8990Этот подтип9192[`PyObject`](https://python-all.ru/3.1/c-api/structures.html#PyObject)9394представляет объект комплексного числа Python.9596**[PyTypeObject](https://python-all.ru/3.1/c-api/type.html#PyTypeObject) `PyComplex_Type`**9798Этот экземпляр99100[`PyTypeObject`](https://python-all.ru/3.1/c-api/type.html#PyTypeObject)101102представляет тип комплексного числа Python. Это тот же объект, что и103104[`complex`](https://python-all.ru/3.1/library/functions.html#complex)105106на уровне Python.107108**int `PyComplex_Check`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*p*)**109110Возвращает true, если аргумент является111112[`PyComplexObject`](https://python-all.ru/3.1/c-api/complex.html#PyComplexObject)113114или подтипом115116[`PyComplexObject`](https://python-all.ru/3.1/c-api/complex.html#PyComplexObject)117118.119120**int `PyComplex_CheckExact`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*p*)**121122Возвращает true, если аргумент является123124[`PyComplexObject`](https://python-all.ru/3.1/c-api/complex.html#PyComplexObject)125126, но не подтипом127128[`PyComplexObject`](https://python-all.ru/3.1/c-api/complex.html#PyComplexObject)129130.131132**[PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject)\* `PyComplex_FromCComplex`([Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) *v*)**133134*Возвращаемое значение: новая ссылка.*135136Создаёт новый объект комплексного числа Python из значения C [`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex).137138**[PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject)\* `PyComplex_FromDoubles`(double *real*, double *imag*)**139140*Возвращаемое значение: новая ссылка.*141142Возвращает новый объект [`PyComplexObject`](https://python-all.ru/3.1/c-api/complex.html#PyComplexObject) из *real* и *imag*.143144**double `PyComplex_RealAsDouble`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*op*)**145146Возвращает действительную часть147148*op*149150как C151152`double`153154.155156**double `PyComplex_ImagAsDouble`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*op*)**157158Возвращает мнимую часть159160*op*161162как C163164`double`165166.167168**[Py\_complex](https://python-all.ru/3.1/c-api/complex.html#Py_complex) `PyComplex_AsCComplex`([PyObject](https://python-all.ru/3.1/c-api/structures.html#PyObject) *\*op*)**169170Возвращает значение [`Py_complex`](https://python-all.ru/3.1/c-api/complex.html#Py_complex) комплексного числа *op*.171172Если *op* не является объектом комплексного числа Python, но имеет метод [`__complex__()`](https://python-all.ru/3.1/reference/datamodel.html#object.__complex__) , то сначала будет вызван этот метод для преобразования *op* в объект комплексного числа Python.173