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.
