`complex.md`

165 строк · 7.9 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.6/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/2.6/c-api/complex.html#Py_complex) `_Py_c_sum`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *right*)**2728Возвращает сумму двух комплексных чисел, используя представление C2930[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)3132.3334**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `_Py_c_diff`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *right*)**3536Возвращает разность двух комплексных чисел, используя представление C3738[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)3940.4142**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `_Py_c_neg`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *complex*)**4344Возвращает отрицание комплексного числа4546*complex*4748, используя представление C4950[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)5152.5354**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `_Py_c_prod`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *left*, [Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *right*)**5556Возвращает произведение двух комплексных чисел, используя представление C5758[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)5960.6162**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `_Py_c_quot`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *dividend*, [Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *divisor*)**6364Возвращает частное двух комплексных чисел, используя представление C6566[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)6768.6970**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `_Py_c_pow`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *num*, [Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *exp*)**7172Возвращает возведение7374*num*7576в степень7778*exp*7980, используя представление C8182[`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex)8384.8586## Комплексные числа как объекты Python8788**`PyComplexObject`**8990Этот подтип9192[`PyObject`](https://python-all.ru/2.6/c-api/structures.html#PyObject)9394представляет объект комплексного числа Python.9596**[PyTypeObject](https://python-all.ru/2.6/c-api/type.html#PyTypeObject) `PyComplex_Type`**9798Этот экземпляр99100[`PyTypeObject`](https://python-all.ru/2.6/c-api/type.html#PyTypeObject)101102представляет тип комплексных чисел Python. Это тот же объект, что и103104`complex`105106и107108`types.ComplexType`109110.111112**int `PyComplex_Check`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*p*)**113114Возвращает true, если аргумент является [`PyComplexObject`](https://python-all.ru/2.6/c-api/complex.html#PyComplexObject) или подтипом [`PyComplexObject`](https://python-all.ru/2.6/c-api/complex.html#PyComplexObject).115116Изменено в версии 2.2: Теперь допускаются подтипы.117118**int `PyComplex_CheckExact`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*p*)**119120Возвращает true, если аргумент является [`PyComplexObject`](https://python-all.ru/2.6/c-api/complex.html#PyComplexObject), но не подтипом [`PyComplexObject`](https://python-all.ru/2.6/c-api/complex.html#PyComplexObject).121122Новое в версии 2.2.123124**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyComplex_FromCComplex`([Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) *v*)**125126*Возвращаемое значение: новая ссылка.*127128Создаёт новый объект комплексного числа Python из значения C [`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex).129130**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyComplex_FromDoubles`(double *real*, double *imag*)**131132*Возвращаемое значение: новая ссылка.*133134Возвращает новый объект [`PyComplexObject`](https://python-all.ru/2.6/c-api/complex.html#PyComplexObject) из *real* и *imag*.135136**double `PyComplex_RealAsDouble`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*op*)**137138Возвращает действительную часть139140*op*141142как C143144`double`145146.147148**double `PyComplex_ImagAsDouble`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*op*)**149150Возвращает мнимую часть151152*op*153154как C155156`double`157158.159160**[Py\_complex](https://python-all.ru/2.6/c-api/complex.html#Py_complex) `PyComplex_AsCComplex`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*op*)**161162Возвращает значение [`Py_complex`](https://python-all.ru/2.6/c-api/complex.html#Py_complex) комплексного числа *op*.163164Изменено в версии 2.6: Если *op* не является объектом комплексного числа Python, но имеет метод [`__complex__()`](https://python-all.ru/2.6/reference/datamodel.html#object.__complex__), то этот метод будет сначала вызван для преобразования *op* в объект комплексного числа Python.165