Python’s complex number objects are implemented as two distinct types when viewed from the C API: one is the Python object exposed to Python programs, and the other is a C structure which represents the actual complex number value. The API provides functions for working with both.
Note that the functions which accept these structures as parameters and return them as results do so by value rather than dereferencing them through pointers. This is consistent throughout the API.
Py_complex
¶
The C structure which corresponds to the value portion of a Python complex number object. Most of the functions for dealing with complex number objects use structures of this type as input or output values, as appropriate. It is defined as:
typedef struct {
double real;
double imag;
} Py_complex;
_Py_c_sum
(
Py_complex
left
,
Py_complex
right
)
¶
Return the sum of two complex numbers, using the C
Py_complex
表示。
_Py_c_diff
(
Py_complex
left
,
Py_complex
right
)
¶
Return the difference between two complex numbers, using the C
Py_complex
表示。
_Py_c_neg
(
Py_complex
complex
)
¶
Return the negation of the complex number
complex
, using the C
Py_complex
表示。
_Py_c_prod
(
Py_complex
left
,
Py_complex
right
)
¶
Return the product of two complex numbers, using the C
Py_complex
表示。
_Py_c_quot
(
Py_complex
dividend
,
Py_complex
divisor
)
¶
Return the quotient of two complex numbers, using the C
Py_complex
表示。
若
divisor
is null, this method returns zero and sets
errno
to
EDOM
.
_Py_c_pow
(
Py_complex
num
,
Py_complex
exp
)
¶
Return the exponentiation of
num
by
exp
, using the C
Py_complex
表示。
若
num
is null and
exp
is not a positive real number, this method returns zero and sets
errno
to
EDOM
.
PyComplex_Type
¶
此实例的
PyTypeObject
represents the Python complex number type. It is the same object as
complex
在 Python 层。
PyComplex_Check
(
PyObject
*p
)
¶
返回 True 若其自变量是
PyComplexObject
或子类型的
PyComplexObject
.
PyComplex_CheckExact
(
PyObject
*p
)
¶
返回 True 若其自变量是
PyComplexObject
,但不是子类型的
PyComplexObject
.
PyComplex_FromCComplex
(
Py_complex
v
)
¶
Create a new Python complex number object from a C
Py_complex
值。
PyComplex_FromDoubles
(
double
real
, double
imag
)
¶
返回新
PyComplexObject
对象从
real
and
imag
.
PyComplex_AsCComplex
(
PyObject
*op
)
¶
返回
Py_complex
value of the complex number
op
.
若
op
is not a Python complex number object but has a
__complex__()
method, this method will first be called to convert
op
to a Python complex number object. Upon failure, this method returns
-1.0
as a real value.