Gecko [ satitravel.com ]

Name	Size	Permission	Date
abstract.rst.txt	715 B	-rw-r--r--	2018-10-20 05:24
allocation.rst.txt	2.59 KB	-rw-r--r--	2018-10-20 05:24
apiabiversion.rst.txt	2.19 KB	-rw-r--r--	2018-10-20 05:24
arg.rst.txt	29.93 KB	-rw-r--r--	2018-10-20 05:24
bool.rst.txt	1.17 KB	-rw-r--r--	2018-10-20 05:24
buffer.rst.txt	21.75 KB	-rw-r--r--	2018-10-20 05:24
bytearray.rst.txt	2.2 KB	-rw-r--r--	2018-10-20 05:24
bytes.rst.txt	9 KB	-rw-r--r--	2018-10-20 05:24
capsule.rst.txt	5.61 KB	-rw-r--r--	2018-10-20 05:24
cell.rst.txt	1.89 KB	-rw-r--r--	2018-10-20 05:24
code.rst.txt	1.63 KB	-rw-r--r--	2018-10-20 05:24
codec.rst.txt	4.69 KB	-rw-r--r--	2018-10-20 05:24
complex.rst.txt	3.85 KB	-rw-r--r--	2018-10-20 05:24
concrete.rst.txt	2 KB	-rw-r--r--	2018-10-20 05:24
conversion.rst.txt	5.39 KB	-rw-r--r--	2018-10-20 05:24
coro.rst.txt	820 B	-rw-r--r--	2018-10-20 05:24
datetime.rst.txt	6.26 KB	-rw-r--r--	2018-10-20 05:24
descriptor.rst.txt	1.08 KB	-rw-r--r--	2018-10-20 05:24
dict.rst.txt	7.77 KB	-rw-r--r--	2018-10-20 05:24
exceptions.rst.txt	46.69 KB	-rw-r--r--	2018-10-20 05:24
file.rst.txt	3.17 KB	-rw-r--r--	2018-10-20 05:24
float.rst.txt	2.19 KB	-rw-r--r--	2018-10-20 05:24
function.rst.txt	3.27 KB	-rw-r--r--	2018-10-20 05:24
gcsupport.rst.txt	5.92 KB	-rw-r--r--	2018-10-20 05:24
gen.rst.txt	1.27 KB	-rw-r--r--	2018-10-20 05:24
import.rst.txt	12.52 KB	-rw-r--r--	2018-10-20 05:24
index.rst.txt	613 B	-rw-r--r--	2018-10-20 05:24
init.rst.txt	51.16 KB	-rw-r--r--	2018-10-20 05:24
intro.rst.txt	28.08 KB	-rw-r--r--	2018-10-20 05:24
iter.rst.txt	1.1 KB	-rw-r--r--	2018-10-20 05:24
iterator.rst.txt	1.6 KB	-rw-r--r--	2018-10-20 05:24
list.rst.txt	4.62 KB	-rw-r--r--	2018-10-20 05:24
long.rst.txt	10.19 KB	-rw-r--r--	2018-10-20 05:24
mapping.rst.txt	2.8 KB	-rw-r--r--	2018-10-20 05:24
marshal.rst.txt	3.48 KB	-rw-r--r--	2018-10-20 05:24
memory.rst.txt	20.87 KB	-rw-r--r--	2018-10-20 05:24
memoryview.rst.txt	2.29 KB	-rw-r--r--	2018-10-20 05:24
method.rst.txt	2.75 KB	-rw-r--r--	2018-10-20 05:24
module.rst.txt	17.84 KB	-rw-r--r--	2018-10-20 05:24
none.rst.txt	740 B	-rw-r--r--	2018-10-20 05:24
number.rst.txt	10.33 KB	-rw-r--r--	2018-10-20 05:24
objbuffer.rst.txt	2.15 KB	-rw-r--r--	2018-10-20 05:24
object.rst.txt	17.01 KB	-rw-r--r--	2018-10-20 05:24
objimpl.rst.txt	304 B	-rw-r--r--	2018-10-20 05:24
refcounting.rst.txt	2.84 KB	-rw-r--r--	2018-10-20 05:24
reflection.rst.txt	1.38 KB	-rw-r--r--	2018-10-20 05:24
sequence.rst.txt	6.39 KB	-rw-r--r--	2018-10-20 05:24
set.rst.txt	6 KB	-rw-r--r--	2018-10-20 05:24
slice.rst.txt	2.35 KB	-rw-r--r--	2018-10-20 05:24
stable.rst.txt	1.92 KB	-rw-r--r--	2018-10-20 05:24
structures.rst.txt	13.46 KB	-rw-r--r--	2018-10-20 05:24
sys.rst.txt	9.71 KB	-rw-r--r--	2018-10-20 05:24
tuple.rst.txt	7.84 KB	-rw-r--r--	2018-10-20 05:24
type.rst.txt	3.87 KB	-rw-r--r--	2018-10-20 05:24
typeobj.rst.txt	58.77 KB	-rw-r--r--	2018-10-20 05:24
unicode.rst.txt	66.48 KB	-rw-r--r--	2018-10-20 05:24
utilities.rst.txt	414 B	-rw-r--r--	2018-10-20 05:24
veryhigh.rst.txt	16.26 KB	-rw-r--r--	2018-10-20 05:24
weakref.rst.txt	2.57 KB	-rw-r--r--	2018-10-20 05:24

Rename

.. highlightlang:: c

.. _complexobjects:

Complex Number Objects
----------------------

.. index:: object: complex number

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.

Complex Numbers as C Structures
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.

.. c:type:: 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;

.. c:function:: Py_complex _Py_c_sum(Py_complex left, Py_complex right)

Return the sum of two complex numbers, using the C :c:type:`Py_complex`
   representation.

.. c:function:: Py_complex _Py_c_diff(Py_complex left, Py_complex right)

Return the difference between two complex numbers, using the C
   :c:type:`Py_complex` representation.

.. c:function:: Py_complex _Py_c_neg(Py_complex complex)

Return the negation of the complex number *complex*, using the C
   :c:type:`Py_complex` representation.

.. c:function:: Py_complex _Py_c_prod(Py_complex left, Py_complex right)

Return the product of two complex numbers, using the C :c:type:`Py_complex`
   representation.

.. c:function:: Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)

Return the quotient of two complex numbers, using the C :c:type:`Py_complex`
   representation.

If *divisor* is null, this method returns zero and sets
   :c:data:`errno` to :c:data:`EDOM`.

.. c:function:: Py_complex _Py_c_pow(Py_complex num, Py_complex exp)

Return the exponentiation of *num* by *exp*, using the C :c:type:`Py_complex`
   representation.

If *num* is null and *exp* is not a positive real number,
   this method returns zero and sets :c:data:`errno` to :c:data:`EDOM`.

Complex Numbers as Python Objects
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. c:type:: PyComplexObject

This subtype of :c:type:`PyObject` represents a Python complex number object.

.. c:var:: PyTypeObject PyComplex_Type

This instance of :c:type:`PyTypeObject` represents the Python complex number
   type. It is the same object as :class:`complex` in the Python layer.

.. c:function:: int PyComplex_Check(PyObject *p)

Return true if its argument is a :c:type:`PyComplexObject` or a subtype of
   :c:type:`PyComplexObject`.

.. c:function:: int PyComplex_CheckExact(PyObject *p)

Return true if its argument is a :c:type:`PyComplexObject`, but not a subtype of
   :c:type:`PyComplexObject`.

.. c:function:: PyObject* PyComplex_FromCComplex(Py_complex v)

Create a new Python complex number object from a C :c:type:`Py_complex` value.

.. c:function:: PyObject* PyComplex_FromDoubles(double real, double imag)

Return a new :c:type:`PyComplexObject` object from *real* and *imag*.

.. c:function:: double PyComplex_RealAsDouble(PyObject *op)

Return the real part of *op* as a C :c:type:`double`.

.. c:function:: double PyComplex_ImagAsDouble(PyObject *op)

Return the imaginary part of *op* as a C :c:type:`double`.

.. c:function:: Py_complex PyComplex_AsCComplex(PyObject *op)

Return the :c:type:`Py_complex` value of the complex number *op*.

If *op* is not a Python complex number object but has a :meth:`__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.