复数对象
********

从C API看，Python的复数对象由两个不同的部分实现：一个是在Python程序使
用的Python对象，另外的是一个代表真正复数值的C结构体。API提供了函数共同
操作两者。


表示复数的C结构体
=================

需要注意的是接受这些结构体的作为参数并当做结果返回的函数，都是传递“值”
而不是引用指针。此规则适用于整个API。

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 complex)

   返回复数 *complex* 的负值，用 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)

   返回 *num* 的 *exp* 次幂，用 C 类型 "Py_complex" 表示。

   如果 *num* 为空且 *exp* 不是正实数，这个方法返回零并设置 "errno" 为
   "EDOM"。


表示复数的Python对象
====================

PyComplexObject

   这个C类型 "PyObject" 的子类型代表一个 Python 复数对象。

PyTypeObject PyComplex_Type

   This instance of "PyTypeObject" represents the Python complex
   number type. It is the same object as "complex" and
   "types.ComplexType".

int PyComplex_Check(PyObject *p)

   如果它的参数是一个C类型 "PyComplexObject" 或者是C类型
   "PyComplexObject" 的子类型，返回真。

   在 2.2 版更改: Allowed subtypes to be accepted.

int PyComplex_CheckExact(PyObject *p)

   如果它的参数是一个C类型 "PyComplexObject" 但不是C类型
   "PyComplexObject" 的子类型，返回真。

   2.2 新版功能.

PyObject* PyComplex_FromCComplex(Py_complex v)
    *Return value: New reference.*

   根据C类型 "Py_complex" 的值生成一个新的Python复数对象。

PyObject* PyComplex_FromDoubles(double real, double imag)
    *Return value: New reference.*

   根据 *real* 和 *imag* 返回一个新的C类型 "PyComplexObject" 对象。

double PyComplex_RealAsDouble(PyObject *op)

   以C类型 "double" 返回 *op* 的实部。

double PyComplex_ImagAsDouble(PyObject *op)

   以C类型 "double" 返回 *op* 的虚部。

Py_complex PyComplex_AsCComplex(PyObject *op)

   Return the "Py_complex" value of the complex number *op*. Upon
   failure, this method returns "-1.0" as a real value.

   在 2.6 版更改: If *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.
