Объекты-срезы

PyTypeObject PySlice_Type

Часть стабильного ABI.

Объект типа для объектов-срезов. На уровне Python это то же самое, что slice.

int PySlice_Check(PyObject *ob)

Возвращает true, если ob является объектом-срезом; ob не должен быть NULL. Эта функция всегда завершается успешно.

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

Возвращаемое значение: новая ссылка. Часть стабильного ABI.

Возвращает новый объект-срез с заданными значениями. Параметры start, stop и step используются в качестве значений атрибутов объекта-среза с такими же именами. Любое из значений может быть NULL, в этом случае для соответствующего атрибута будет использовано None.

Возвращает NULL с установленным исключением, если не удалось выделить память для нового объекта.

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

Часть стабильного ABI.

Извлекает индексы начала, конца и шага из объекта-среза slice, предполагая, что длина последовательности равна length. Считает ошибкой индексы, превышающие length.

В случае успеха возвращает 0, а в случае ошибки — -1 без установленного исключения (если только один из индексов не был None и его не удалось преобразовать в целое число; в этом случае возвращается -1 с установленным исключением).

Вероятно, вам не следует использовать эту функцию.

Изменено в версии 3.2: Ранее тип параметра slice был 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)

Часть стабильного ABI.

Подходящая замена для PySlice_GetIndices(). Извлекает индексы начала, конца и шага из объекта-среза slice, предполагая, что длина последовательности равна length, и записывает длину среза в slicelength. Индексы за пределами допустимого диапазона обрезаются так же, как при обработке обычных срезов.

В случае успеха возвращает 0, а в случае ошибки — -1 с установленным исключением.

Примечание

Эта функция считается небезопасной для изменяемых последовательностей. Её следует заменить комбинацией PySlice_Unpack() и PySlice_AdjustIndices(), где

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

заменяется на

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

Изменено в версии 3.2: Ранее тип параметра slice был PySliceObject*.

Изменено в версии 3.6.1: Если Py_LIMITED_API не задан или задано значение в диапазоне от 0x03050400 до 0x03060000 (не включая верхнюю границу) либо 0x03060100 или выше, PySlice_GetIndicesEx() реализуется как макрос с использованием PySlice_Unpack() и PySlice_AdjustIndices(). Аргументы start, stop и step вычисляются более одного раза.

Устарело с версии 3.6.1: Если Py_LIMITED_API задано значение меньше 0x03050400 или в диапазоне от 0x03060000 до 0x03060100 (не включая верхнюю границу), PySlice_GetIndicesEx() является устаревшей функцией.

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

Часть стабильного ABI начиная с версии 3.7.

Извлекает поля данных start, stop и step из объекта-среза в виде целых чисел C. Без предупреждения уменьшает значения больше PY_SSIZE_T_MAX до PY_SSIZE_T_MAX, без предупреждения увеличивает значения start и stop меньше PY_SSIZE_T_MIN до PY_SSIZE_T_MIN, а значения step меньше -PY_SSIZE_T_MAX — до -PY_SSIZE_T_MAX.

В случае ошибки возвращает -1 с установленным исключением, в случае успеха — 0.

Добавлено в версии 3.6.1.

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

Часть стабильного ABI начиная с версии 3.7.

Корректирует индексы начала и конца среза, предполагая последовательность заданной длины. Индексы за пределами допустимого диапазона обрезаются так же, как при обработке обычных срезов.

Возвращает длину среза. Всегда завершается успешно. Не вызывает код Python.

Добавлено в версии 3.6.1.