切片对象

PyTypeObject PySlice_Type

是 稳定 ABI 的一部分。

切片对象的类型对象。这与 Python 层中的 slice 相同。

int PySlice_Check(PyObject *ob)

如果 ob 是一个切片对象，则返回 True；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)

自 3.7 版本起，成为 稳定 ABI 的一部分。

从切片对象中提取开始、结束和步长数据成员作为 C 整数。将大于 PY_SSIZE_T_MAX 的值静默地减少到 PY_SSIZE_T_MAX，将小于 PY_SSIZE_T_MIN 的开始和结束值静默地提升到 PY_SSIZE_T_MIN，并将小于 -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)

自 3.7 版本起，成为 稳定 ABI 的一部分。

假设指定长度的序列，调整开始/结束切片索引。超出范围的索引以与处理普通切片一致的方式进行裁剪。

返回切片的长度。始终成功。不调用 Python 代码。

在 3.6.1 版本中添加。

省略号对象

PyObject *Py_Ellipsis

Python Ellipsis 对象。此对象没有方法。与 Py_None 一样，它是一个 不朽 的单例对象。

在 3.12 版本中更改: Py_Ellipsis 是不朽的。