復數(shù)對象?
從C API看,Python的復數(shù)對象由兩個不同的部分實現(xiàn):一個是在Python程序使用的Python對象,另外的是一個代表真正復數(shù)值的C結(jié)構(gòu)體。API提供了函數(shù)共同操作兩者。
表示復數(shù)的C結(jié)構(gòu)體?
需要注意的是接受這些結(jié)構(gòu)體的作為參數(shù)并當做結(jié)果返回的函數(shù),都是傳遞“值”而不是引用指針。此規(guī)則適用于整個API。
-
type Py_complex?
這是一個對應(yīng)Python復數(shù)對象的值部分的C結(jié)構(gòu)體。絕大部分處理復數(shù)對象的函數(shù)都用這類型的結(jié)構(gòu)體作為輸入或者輸出值,它可近似地定義為:
typedef struct { double real; double imag; } Py_complex;
-
Py_complex _Py_c_sum(Py_complex left, Py_complex right)?
返回兩個復數(shù)的和,用 C 類型
Py_complex
表示。
-
Py_complex _Py_c_diff(Py_complex left, Py_complex right)?
返回兩個復數(shù)的差,用 C 類型
Py_complex
表示。
-
Py_complex _Py_c_neg(Py_complex num)?
返回復數(shù) num 的負值,用 C
Py_complex
表示。
-
Py_complex _Py_c_prod(Py_complex left, Py_complex right)?
返回兩個復數(shù)的乘積,用 C 類型
Py_complex
表示。
-
Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)?
返回兩個復數(shù)的商,用 C 類型
Py_complex
表示。如果 divisor 為空,這個方法返回零并設(shè)置
errno
為EDOM
。
-
Py_complex _Py_c_pow(Py_complex num, Py_complex exp)?
返回 num 的 exp 次冪,用 C 類型
Py_complex
表示。如果 num 為空且 exp 不是正實數(shù),這個方法返回零并設(shè)置
errno
為EDOM
。
表示復數(shù)的Python對象?
-
PyTypeObject PyComplex_Type?
- Part of the Stable ABI.
這是個屬于
PyTypeObject
的代表Python復數(shù)類型的實例。在Python層面的類型complex
是同一個對象。
-
int PyComplex_Check(PyObject *p)?
如果它的參數(shù)是一個
PyComplexObject
或者PyComplexObject
的子類型則返回真值。 此函數(shù)總是會成功執(zhí)行。
-
int PyComplex_CheckExact(PyObject *p)?
如果它的參數(shù)是一個
PyComplexObject
但不是PyComplexObject
的子類型則返回真值。 此函數(shù)總是會成功執(zhí)行。
-
PyObject *PyComplex_FromCComplex(Py_complex v)?
- Return value: New reference.
根據(jù)C類型
Py_complex
的值生成一個新的Python復數(shù)對象。
-
PyObject *PyComplex_FromDoubles(double real, double imag)?
- Return value: New reference. Part of the Stable ABI.
根據(jù) real 和 imag 返回一個新的C類型
PyComplexObject
對象。
-
double PyComplex_RealAsDouble(PyObject *op)?
- Part of the Stable ABI.
以C類型 double 返回 op 的實部。
-
double PyComplex_ImagAsDouble(PyObject *op)?
- Part of the Stable ABI.
以C類型 double 返回 op 的虛部。
-
Py_complex PyComplex_AsCComplex(PyObject *op)?
返回復數(shù) op 的C類型
Py_complex
值。如果 op 不是一個 Python 復數(shù)對象,但是具有
__complex__()
方法,此方法將首先被調(diào)用,將 op 轉(zhuǎn)換為一個 Python 復數(shù)對象。 如果__complex__()
未定義則將回退至__float__()
,如果__float__()
未定義則將回退至__index__()
。 如果失敗,此方法將返回-1.0
作為實數(shù)值。在 3.8 版更改: 如果可用將使用
__index__()
。