Objetos números complexos¶
Os objetos números complexos do Python são implementados como dois tipos distintos quando visualizados na API C: um é o objeto Python exposto aos programas Python e o outro é uma estrutura C que representa o valor real do número complexo. A API fornece funções para trabalhar com ambos.
Números complexos como estruturas C.¶
Observe que as funções que aceitam essas estruturas como parâmetros e as retornam como resultados o fazem por valor em vez de desreferenciá-las por meio de ponteiros. Isso é consistente em toda a API.
-
type Py_complex¶
A estrutura C que corresponde à parte do valor de um objeto de número complexo Python. A maioria das funções para lidar com objetos de números complexos usa estruturas desse tipo como valores de entrada ou saída, conforme apropriado.
A estrutura é definida como:
typedef struct { double real; double imag; } Py_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
.
-
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
.
-
Py_complex _Py_c_neg(Py_complex num)¶
Retorna a negação do número complexo num, utilizando a representação C
Py_complex
.
-
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
.
-
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
paraEDOM
.
-
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
paraEDOM
.
Números complexos como objetos Python¶
-
PyTypeObject PyComplex_Type¶
- Parte da ABI Estável.
Esta instância de
PyTypeObject
representa o tipo de número complexo Python. É o mesmo objeto quecomplex
na camada Python.
-
int PyComplex_Check(PyObject *p)¶
Retorna true se seu argumento é um
PyComplexObject
ou um subtipo dePyComplexObject
. Esta função sempre tem sucesso.
-
int PyComplex_CheckExact(PyObject *p)¶
Retorna true se seu argumento é um
PyComplexObject
, mas não um subtipo dePyComplexObject
. Esta função sempre tem sucesso.
-
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
. RetornaNULL
com uma exceção definida ao ocorrer um erro.
-
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. RetornaNULL
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.
Em caso de falha, este método retorna
-1.0
com uma exceção definida, então deve-se chamarPyErr_Occurred()
para verificar se há erros.
-
double PyComplex_ImagAsDouble(PyObject *op)¶
- Parte da ABI Estável.
Retorna a parte imaginária de op como um double C.
-
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
comreal
definido para-1.0
e com uma exceção definida, então deve-se chamarPyErr_Occurred()
para verificar se há erros.Alterado na versão 3.8: Usa
__index__()
, se disponível.