复数对象¶
从 C API 的角度来看,Python 的复数对象被实现为两种不同的类型:一种是暴露给 Python 程序的 Python 对象,另一种是表示实际复数值的 C 结构体。API 提供了用于处理这两种类型的函数。
复数作为 C 结构体¶
请注意,接受这些结构体作为参数并将其作为结果返回的函数是按值进行操作的,而不是通过指针进行解引用。这在整个 API 中都是一致的。
-
type Py_complex¶
与 Python 复数对象的值部分相对应的 C 结构体。大多数用于处理复数对象的函数使用这种类型的结构体作为输入或输出值,具体取决于情况。它被定义为
typedef struct { double real; double imag; } Py_complex;
-
Py_complex _Py_c_sum(Py_complex left, Py_complex right)¶
返回两个复数的和,使用 C
Py_complex
表示。
-
Py_complex _Py_c_diff(Py_complex left, Py_complex right)¶
返回两个复数的差,使用 C
Py_complex
表示。
-
Py_complex _Py_c_neg(Py_complex num)¶
返回复数 num 的负数,使用 C
Py_complex
表示。
-
Py_complex _Py_c_prod(Py_complex left, Py_complex right)¶
返回两个复数的积,使用 C
Py_complex
表示。
-
Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)¶
返回两个复数的商,使用 C
Py_complex
表示。如果 divisor 为空,则此方法返回零并将
errno
设置为EDOM
。
-
Py_complex _Py_c_pow(Py_complex num, Py_complex exp)¶
使用 C
Py_complex
表示形式返回 num 的 exp 次方。如果 num 为空且 exp 不是正实数,则此方法返回零并将
errno
设置为EDOM
。
复数作为 Python 对象¶
-
PyTypeObject PyComplex_Type¶
- 是 稳定 ABI 的一部分。
此
PyTypeObject
实例表示 Python 复数类型。它与 Python 层中的complex
是同一个对象。
-
int PyComplex_Check(PyObject *p)¶
如果其参数是
PyComplexObject
或PyComplexObject
的子类型,则返回 true。此函数始终成功。
-
int PyComplex_CheckExact(PyObject *p)¶
如果其参数是
PyComplexObject
,但不是PyComplexObject
的子类型,则返回 true。此函数始终成功。
-
PyObject *PyComplex_FromCComplex(Py_complex v)¶
- 返回值:新引用。
从 C
Py_complex
值创建一个新的 Python 复数对象。
-
PyObject *PyComplex_FromDoubles(double real, double imag)¶
- 返回值:新引用。 属于 稳定 ABI 的一部分。
从 real 和 imag 返回一个新的
PyComplexObject
对象。
-
Py_complex PyComplex_AsCComplex(PyObject *op)¶
返回复数 op 的
Py_complex
值。如果 op 不是 Python 复数对象,但具有
__complex__()
方法,则此方法将首先被调用以将 op 转换为 Python 复数对象。如果未定义__complex__()
,则它将回退到__float__()
。如果未定义__float__()
,则它将回退到__index__()
。失败时,此方法将返回-1.0
作为实数值。在 3.8 版中变更: 如果可用,则使用
__index__()
。