Objetos Inteiros¶
Todos os inteiros são implementados como objetos inteiros “longos” de tamanho arbitrário.
Em caso de erro, a maioria das APIs PyLong_As*
retorna (tipo de retorno)-1
que não pode ser distinguido de um número. Use PyErr_Occurred()
para desambiguar.
-
type
PyLongObject
¶ - Part of the Stable ABI.
Este subtipo de
PyObject
representa um objeto inteiro Python.
-
PyTypeObject
PyLong_Type
¶ - Part of the Stable ABI.
Esta instância de
PyTypeObject
representa o tipo inteiro Python. Este é o mesmo objeto queint
na camada Python.
-
int
PyLong_Check
(PyObject *p)¶ Retorna true se seu argumento é um
PyLongObject
ou um subtipo dePyLongObject
. Esta função sempre tem sucesso.
-
int
PyLong_CheckExact
(PyObject *p)¶ Retorna true se seu argumento é um
PyLongObject
, mas não um subtipo dePyLongObject
. Esta função sempre tem sucesso.
-
PyObject *
PyLong_FromLong
(long v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de v ouNULL
em caso de falha.The current implementation keeps an array of integer objects for all integers between
-5
and256
. When you create an int in that range you actually just get back a reference to the existing object.
-
PyObject *
PyLong_FromUnsignedLong
(unsigned long v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de um unsigned long C ouNULL
em caso de falha.
-
PyObject *
PyLong_FromSsize_t
(Py_ssize_t v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de umPy_ssize_t
C ouNULL
em caso de falha.
-
PyObject *
PyLong_FromSize_t
(size_t v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de umsize_t
C ouNULL
em caso de falha.
-
PyObject *
PyLong_FromLongLong
(long long v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de um long long C ouNULL
em caso de falha.
-
PyObject *
PyLong_FromUnsignedLongLong
(unsigned long long v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
de um unsigned long long C ouNULL
em caso de falha.
-
PyObject *
PyLong_FromDouble
(double v)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo objeto
PyLongObject
da parte inteira de v ouNULL
em caso de falha.
-
PyObject *
PyLong_FromString
(const char *str, char **pend, int base)¶ - Return value: New reference. Part of the Stable ABI.
Retorna um novo
PyLongObject
com base no valor da string em str, que é interpretado de acordo com a raiz em base. Se pend não forNULL
, *pend apontará para o primeiro caractere em str que segue a representação do número. Se base for0
, str é interpretado usando a definição de Inteiros Literais; neste caso, zeros à esquerda em um número decimal diferente de zero aumenta umValueError
. Se base não for0
, deve estar entre2
e36
, inclusive. Espaços iniciais e sublinhados simples após um especificador de base e entre dígitos são ignorados. Se não houver dígitos,ValueError
será levantada.
-
PyObject *
PyLong_FromUnicodeObject
(PyObject *u, int base)¶ - Return value: New reference.
Converte uma sequência de dígitos Unicode na string u para um valor inteiro Python.
Novo na versão 3.3.
-
PyObject *
PyLong_FromVoidPtr
(void *p)¶ - Return value: New reference. Part of the Stable ABI.
Cria um inteiro Python a partir do ponteiro p. O valor do ponteiro pode ser recuperado do valor resultante usando
PyLong_AsVoidPtr()
.
-
long
PyLong_AsLong
(PyObject *obj)¶ - Part of the Stable ABI.
Return a C long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Levanta
OverflowError
se o valor de obj estiver fora do intervalo de um long.Retorna
-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
long
PyLong_AsLongAndOverflow
(PyObject *obj, int *overflow)¶ - Part of the Stable ABI.
Return a C long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Se o valor de obj for maior que
LONG_MAX
ou menor queLONG_MIN
, define *overflow para1
ou-1
, respectivamente, e retorna-1
; caso contrário, define *overflow para0
. Se qualquer outra exceção ocorrer, define *overflow para0
e retorne-1
como de costume.Retorna
-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
long long
PyLong_AsLongLong
(PyObject *obj)¶ - Part of the Stable ABI.
Return a C long long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Levanta
OverflowError
se o valor de obj estiver fora do intervalo de um long long.Retorna
-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
long long
PyLong_AsLongLongAndOverflow
(PyObject *obj, int *overflow)¶ - Part of the Stable ABI.
Return a C long long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Se o valor de obj for maior que
LLONG_MAX
ou menor queLLONG_MIN
, define *overflow para1
ou-1
, respectivamente, e retorna-1
; caso contrário, define *overflow para0
. Se qualquer outra exceção ocorrer, define *overflow para0
e retorne-1
como de costume.Retorna
-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Novo na versão 3.2.
Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
Py_ssize_t
PyLong_AsSsize_t
(PyObject *pylong)¶ - Part of the Stable ABI.
Retorna uma representação de
Py_ssize_t
C de pylong. pylong deve ser uma instância dePyLongObject
.Levanta
OverflowError
se o valor de pylong estiver fora do intervalo de umPy_ssize_t
.Retorna
-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.
-
unsigned long
PyLong_AsUnsignedLong
(PyObject *pylong)¶ - Part of the Stable ABI.
Retorna uma representação de unsigned long C de pylong. pylong deve ser uma instância de
PyLongObject
.Levanta
OverflowError
se o valor de pylong estiver fora do intervalo de um unsigned long.Retorna
(unsigned long)-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.
-
size_t
PyLong_AsSize_t
(PyObject *pylong)¶ - Part of the Stable ABI.
Retorna uma representação de
size_t
C de pylong. pylong deve ser uma instância dePyLongObject
.Levanta
OverflowError
se o valor de pylong estiver fora do intervalo de umsize_t
.Retorna
(size)-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.
-
unsigned long long
PyLong_AsUnsignedLongLong
(PyObject *pylong)¶ - Part of the Stable ABI.
Retorna uma representação de unsigned long long C de pylong. pylong deve ser uma instância de
PyLongObject
.Levanta
OverflowError
se o valor de pylong estiver fora do intervalo de um unsigned long long.Retorna
(unsigned long long)-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.1: Um pylong negativo agora levanta
OverflowError
, nãoTypeError
.
-
unsigned long
PyLong_AsUnsignedLongMask
(PyObject *obj)¶ - Part of the Stable ABI.
Return a C unsigned long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Se o valor de obj estiver fora do intervalo para um unsigned long, retorna a redução desse módulo de valor
ULONG_MAX + 1
.Retorna
(unsigned long)-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
unsigned long long
PyLong_AsUnsignedLongLongMask
(PyObject *obj)¶ - Part of the Stable ABI.
Return a C unsigned long long representation of obj. If obj is not an instance of
PyLongObject
, first call its__index__()
method (if present) to convert it to aPyLongObject
.Se o valor de obj estiver fora do intervalo para um unsigned long long, retorna a redução desse módulo de valor
ULLONG_MAX + 1
.Retorna
(unsigned long long)-1
no caso de erro. UsePyErr_Occurred()
para desambiguar.Alterado na versão 3.8: Usa
__index__()
, se disponível.Alterado na versão 3.10: This function will no longer use
__int__()
.
-
double
PyLong_AsDouble
(PyObject *pylong)¶ - Part of the Stable ABI.
Retorna uma representação de double C de pylong. pylong deve ser uma instância de
PyLongObject
.Levanta
OverflowError
se o valor de pylong estiver fora do intervalo de um double.Retorna
-1.0
no caso de erro. UsePyErr_Occurred()
para desambiguar.
-
void *
PyLong_AsVoidPtr
(PyObject *pylong)¶ - Part of the Stable ABI.
Converte um inteiro Python pylong em um ponteiro void C. Se pylong não puder ser convertido, uma
OverflowError
será levantada. Isso só é garantido para produzir um ponteiro utilizável void para valores criados comPyLong_FromVoidPtr()
.Retorna
NULL
no caso de erro. UsePyErr_Occurred()
para desambiguar.