切片对象 ¶

PyTypeObject PySlice_Type ¶

属于 稳定 ABI (应用程序二进制接口) .

The type object for slice objects. This is the same as slice 在 Python 层。

int PySlice_Check ( PyObject * ob ) ¶

返回 True 若 ob is a slice object; ob 不得为 NULL . This function always succeeds.

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

返回值：新引用。 属于 稳定 ABI (应用程序二进制接口) .

Return a new slice object with the given values. The start , stop ，和 step parameters are used as the values of the slice object attributes of the same names. Any of the values may be NULL , in which case the None will be used for the corresponding attribute. Return NULL if the new object could not be allocated.

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

属于 稳定 ABI (应用程序二进制接口) .

Retrieve the start, stop and step indices from the slice object slice , assuming a sequence of length length . Treats indices greater than length as errors.

返回 0 on success and -1 on error with no exception set (unless one of the indices was not None and failed to be converted to an integer, in which case -1 is returned with an exception set).

You probably do not want to use this function.

3.2 版改变： The parameter type for the slice parameter was PySliceObject* before.

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 (应用程序二进制接口) .

Usable replacement for PySlice_GetIndices() . Retrieve the start, stop, and step indices from the slice object slice assuming a sequence of length length , and store the length of the slice in slicelength . Out of bounds indices are clipped in a manner consistent with the handling of normal slices.

返回 0 on success and -1 on error with exception set.

注意

This function is considered not safe for resizable sequences. Its invocation should be replaced by a combination of PySlice_Unpack() and PySlice_AdjustIndices() where

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 版改变： The parameter type for the slice parameter was PySliceObject* before.

3.6.1 版改变： 若 Py_LIMITED_API is not set or set to the value between 0x03050400 and 0x03060000 (not including) or 0x03060100 or higher PySlice_GetIndicesEx() is implemented as a macro using PySlice_Unpack() and PySlice_AdjustIndices() . Arguments start , stop and step are evaluated more than once.

内容表

• 切片对象
  • 省略对象

上一话题

描述符对象

下一话题

内存视图对象

本页

• 报告 Bug
• 展示源