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 que int na camada Python.

int PyLong_Check(PyObject *p)

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

int PyLong_CheckExact(PyObject *p)

Retorna true se seu argumento é um PyLongObject, mas não um subtipo de PyLongObject. 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 ou NULL em caso de falha.

A implementação atual mantém um vetor de objetos inteiros para todos os inteiros entre -5 e 256, quando você cria um int nesse intervalo, você na verdade apenas obtém uma referência ao objeto existente.

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 ou NULL 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 um Py_ssize_t C ou NULL 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 um size_t C ou NULL 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 ou NULL 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 ou NULL 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 ou NULL 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 for NULL, *pend apontará para o primeiro caractere em str que segue a representação do número. Se base for 0, str é interpretado usando a definição de Inteiros Literais; neste caso, zeros à esquerda em um número decimal diferente de zero aumenta um ValueError. Se base não for 0, deve estar entre 2 e 36, 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 a PyLongObject.

Levanta OverflowError se o valor de obj estiver fora do intervalo de um long.

Retorna -1 no caso de erro. Use PyErr_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 a PyLongObject.

Se o valor de obj for maior que LONG_MAX ou menor que LONG_MIN, define *overflow para 1 ou -1, respectivamente, e retorna -1; caso contrário, define *overflow para 0. Se qualquer outra exceção ocorrer, define *overflow para 0 e retorne -1 como de costume.

Retorna -1 no caso de erro. Use PyErr_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 a PyLongObject.

Levanta OverflowError se o valor de obj estiver fora do intervalo de um long long.

Retorna -1 no caso de erro. Use PyErr_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 a PyLongObject.

Se o valor de obj for maior que LLONG_MAX ou menor que LLONG_MIN, define *overflow para 1 ou -1, respectivamente, e retorna -1; caso contrário, define *overflow para 0. Se qualquer outra exceção ocorrer, define *overflow para 0 e retorne -1 como de costume.

Retorna -1 no caso de erro. Use PyErr_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 de PyLongObject.

Levanta OverflowError se o valor de pylong estiver fora do intervalo de um Py_ssize_t.

Retorna -1 no caso de erro. Use PyErr_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. Use PyErr_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 de PyLongObject.

Levanta OverflowError se o valor de pylong estiver fora do intervalo de um size_t.

Retorna (size)-1 no caso de erro. Use PyErr_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. Use PyErr_Occurred() para desambiguar.

Alterado na versão 3.1: Um pylong negativo agora levanta OverflowError, não TypeError.

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 a PyLongObject.

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. Use PyErr_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 a PyLongObject.

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. Use PyErr_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. Use PyErr_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 com PyLong_FromVoidPtr().

Retorna NULL no caso de erro. Use PyErr_Occurred() para desambiguar.