Objetos números complexos

type PyComplexObject

Este subtipo de PyObject representa um objeto Python de número complexo.

Py_complex cval

The complex number value, using the C Py_complex representation.

Deprecated since version 3.15.0a0 (unreleased), will be removed in version 3.20: Use PyComplex_AsCComplex() and PyComplex_FromCComplex() to convert a Python complex number to/from the C Py_complex representation.

PyTypeObject PyComplex_Type
Parte da ABI Estável.

Esta instância de PyTypeObject representa o tipo de número complexo Python. É o mesmo objeto que complex na camada Python.

int PyComplex_Check(PyObject *p)

Retorna true se seu argumento é um PyComplexObject ou um subtipo de PyComplexObject. Esta função sempre tem sucesso.

int PyComplex_CheckExact(PyObject *p)

Retorna true se seu argumento é um PyComplexObject, mas não um subtipo de PyComplexObject. Esta função sempre tem sucesso.

PyObject *PyComplex_FromDoubles(double real, double imag)
Retorna valor: Nova referência. Parte da ABI Estável.

Retorna um novo objeto PyComplexObject de real e imag. Retorna NULL com uma exceção definida ao ocorrer um erro.

double PyComplex_RealAsDouble(PyObject *op)
Parte da ABI Estável.

Retorna a parte real de op como um double C.

Se op não é um objeto de número complexo Python, mas tem um método __complex__(), este método será primeiro chamado para converter op em um objeto de número complexo Python. Se __complex__() não estiver definido, ele volta a chamar PyFloat_AsDouble() e retorna seu resultado.

Em caso de falha, este método retorna -1.0 com uma exceção definida, então deve-se chamar PyErr_Occurred() para verificar se há erros.

Alterado na versão 3.13: Usa __complex__(), se disponível.

double PyComplex_ImagAsDouble(PyObject *op)
Parte da ABI Estável.

Retorna a parte imaginária de op como um double C.

Se op não é um objeto de número complexo Python, mas tem um método __complex__(), este método será primeiro chamado para converter op em um objeto de número complexo Python. Se __complex__() não estiver definido, ele volta a chamar PyFloat_AsDouble() e retorna 0.0 em caso de sucesso.

Em caso de falha, este método retorna -1.0 com uma exceção definida, então deve-se chamar PyErr_Occurred() para verificar se há erros.

Alterado na versão 3.13: Usa __complex__(), se disponível.

type Py_complex

This C structure defines export format for a Python complex number object.

double real
double imag

A estrutura é definida como:

typedef struct {
    double real;
    double imag;
} Py_complex;
PyObject *PyComplex_FromCComplex(Py_complex v)
Retorna valor: Nova referência.

Cria um novo objeto de número complexo Python a partir de um valor C Py_complex. Retorna NULL com uma exceção definida ao ocorrer um erro.

Py_complex PyComplex_AsCComplex(PyObject *op)

Retorna o valor Py_complex do número complexo op.

Se op não é um objeto de número complexo Python, mas tem um método __complex__(), este método será primeiro chamado para converter op em um objeto de número complexo Python. Se __complex__() não for definido, então ele recorre a __float__(). Se __float__() não estiver definido, então ele volta para __index__().

Em caso de falha, este método retorna Py_complex com real definido para -1.0 e com uma exceção definida, então deve-se chamar PyErr_Occurred() para verificar se há erros.

Alterado na versão 3.8: Usa __index__(), se disponível.

Números complexos como estruturas C.

The API also provides functions for working with complex numbers, using the Py_complex representation. 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.

Please note, that these functions are soft deprecated since Python 3.15. Avoid using this API in a new code to do complex arithmetic: either use the Number Protocol API or use native complex types, like double complex.

Py_complex _Py_c_sum(Py_complex left, Py_complex right)

Retorna a soma de dois números complexos, utilizando a representação C Py_complex.

Descontinuado desde a versão 3.15.

Py_complex _Py_c_diff(Py_complex left, Py_complex right)

Retorna a diferença entre dois números complexos, utilizando a representação C Py_complex.

Descontinuado desde a versão 3.15.

Py_complex _Py_c_neg(Py_complex num)

Retorna a negação do número complexo num, utilizando a representação C Py_complex.

Descontinuado desde a versão 3.15.

Py_complex _Py_c_prod(Py_complex left, Py_complex right)

Retorna o produto de dois números complexos, utilizando a representação C Py_complex.

Descontinuado desde a versão 3.15.

Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)

Retorna o quociente de dois números complexos, utilizando a representação C Py_complex.

Se divisor é nulo, este método retorna zero e define errno para EDOM.

Descontinuado desde a versão 3.15.

Py_complex _Py_c_pow(Py_complex num, Py_complex exp)

Retorna a exponenciação de num por exp, utilizando a representação C Py_complex

Se num for nulo e exp não for um número real positivo, este método retorna zero e define errno para EDOM.

Define errno para ERANGE em caso de estouros.

Descontinuado desde a versão 3.15.

double _Py_c_abs(Py_complex num)

Return the absolute value of the complex number num.

Define errno para ERANGE em caso de estouros.

Descontinuado desde a versão 3.15.