Objetos Slice

PyTypeObject PySlice_Type

Parte da ABI Estável.

Tipo de objeto para objetos fatia. Isso é o mesmo que slice na camada Python.

int PySlice_Check(PyObject *ob)

Retorna true se ob for um objeto fatia; ob não deve ser NULL. Esta função sempre tem sucesso.

PyObject *PySlice_New(PyObject *start, PyObject *stop, PyObject *step)

Retorna valor: Nova referência. Parte da ABI Estável.

Retorna um novo objeto fatia com os valores fornecidos. Os parâmetros start, stop e step são usados como os valores dos atributos do objeto fatia com os mesmos nomes. Qualquer um dos valores pode ser NULL, caso em que None será usado para o atributo correspondente.

Retorna NULL com uma exceção definida se o novo objeto não puder ser alocado.

int PySlice_GetIndices(PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)

Parte da ABI Estável.

Recupera os índices de início, parada e intermediário do objeto fatia slice, presumindo uma sequência de comprimento length. Trata índices maiores que length como erros.

Retorna 0 em caso de sucesso e -1 em caso de erro sem exceção definida (a menos que um dos índices não fosse None e falhou ao ser convertido para um inteiro, neste caso -1 é retornado com uma exceção definida).

Você provavelmente não deseja usar esta função.

Alterado na versão 3.2: O tipo de parâmetro para o parâmetro slice era antes de PySliceObject*.

int PySlice_GetIndicesEx(PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step, Py_ssize_t *slicelength)

Parte da ABI Estável.

Substituição utilizável para PySlice_GetIndices(). Recupera os índices de início, parada e intermediário do objeto fatia slice presumindo uma sequência de comprimento length e armazena o comprimento da fatia em slicelength. Índices fora dos limites são cortados de maneira consistente com o tratamento de fatias normais.

Retorna 0 em caso de sucesso e -1 em caso de erro com uma exceção definida.

Nota

Esta função não é considerada segura para sequências redimensionáveis. Sua invocação deve ser substituída por uma combinação de PySlice_Unpack() e PySlice_AdjustIndices() sendo

if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) {
    // retorna erro
}

substituído por

if (PySlice_Unpack(slice, &start, &stop, &step) < 0) {
    // retorna erro
}
slicelength = PySlice_AdjustIndices(length, &start, &stop, step);

Alterado na versão 3.2: O tipo de parâmetro para o parâmetro slice era antes de PySliceObject*.

Alterado na versão 3.6.1: Se Py_LIMITED_API não estiver definido ou estiver definido com um valor entre 0x03050400 e 0x03060000 (não incluso) ou 0x03060100 ou mais alto, PySlice_GetIndicesEx() é implementado como uma macro usando PySlice_Unpack() e PySlice_AdjustIndices(). Os argumentos start, stop e step são avaliados mais de uma vez.

Descontinuado desde a versão 3.6.1: Se Py_LIMITED_API estiver definido para um valor menor que 0x03050400 ou entre 0x03060000 e 0x03060100 (não incluso), PySlice_GetIndicesEx() é uma função descontinuada.

int PySlice_Unpack(PyObject *slice, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)

Parte da ABI Estável desde a versão 3.7.

Extrai os membros de dados de início, parada e intermediário de um objeto fatia como C inteiros. Reduz silenciosamente os valores maiores do que PY_SSIZE_T_MAX para PY_SSIZE_T_MAX, aumenta silenciosamente os valores de início e parada menores que PY_SSIZE_T_MIN para PY_SSIZE_T_MIN, e silenciosamente aumenta os valores de intermediário menores que -PY_SSIZE_T_MAX para -PY_SSIZE_T_MAX.

Retorna -1 com uma exceção definida em caso de erro, 0 em caso de sucesso.

Adicionado na versão 3.6.1.

Py_ssize_t PySlice_AdjustIndices(Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t step)

Parte da ABI Estável desde a versão 3.7.

Ajusta os índices de fatias inicial/final presumindo uma sequência do comprimento especificado. Índices fora dos limites são cortados de maneira consistente com o tratamento de fatias normais.

Retorna o comprimento da fatia. Sempre bem-sucedido. Não chama o código Python.

Adicionado na versão 3.6.1.

Objeto Ellipsis

PyTypeObject PyEllipsis_Type

Parte da ABI Estável.

O tipo do objeto Python Ellipsis. O mesmo que types.EllipsisType na camada Python.

PyObject *Py_Ellipsis

O objeto Python Ellipsis. Este objeto não tem métodos. Como Py_None, é um objeto singleton imortal.

Alterado na versão 3.12: Py_Ellipsis é imortal.