切片对象
********

PyTypeObject PySlice_Type
    * 属于 稳定 ABI.*

   切片对象的类型对象。 它与 Python 层面的 "slice" 是相同的对象。

int PySlice_Check(PyObject *ob)

   如果 *ob* 是一个 slice 对象则返回真值；*ob* 必须不为 "NULL"。 此函
   数总是会成功执行。

PyObject *PySlice_New(PyObject *start, PyObject *stop, PyObject *step)
    *返回值：新的引用。** 属于 稳定 ABI.*

   返回一个具有给定值的新切片对象。 *start*, *stop* 和 *step* 形参会被
   用作 slice 对象相应名称的属性的值。 这些值中的任何一个都可以为
   "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* 提取 start, stop 和 step 索引号，将序列长度视为
   *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* 提取 start,
   stop 和 step 索引号，将序列长度视为 *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"，静默地将小于
   "PY_SSIZE_T_MIN" 的 start 和 stop 值增大为 "PY_SSIZE_T_MIN"，并静默
   地将小于 "-PY_SSIZE_T_MAX" 的 step 值增大为 "-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 版起.*

   将 start/end 切片索引号根据指定的序列长度进行调整。 超出范围的索引
   号会以与普通切片一致的方式进行剪切。

   返回切片的长度。 此操作总是会成功。 不会调用 Python 代码。

   在 3.6.1 版本加入.


Ellipsis 对象
=============

PyObject *Py_Ellipsis

   Python 的 "Ellipsis" 对象。 该对象没有任何方法。 它必须以与任何其他
   对象一样的方式遵循引用计数。 它与 "Py_None" 一样属于单例对象。
