序列协议¶
-
int PySequence_Check(PyObject *o)¶
返回
1
如果对象提供序列协议,并且0
否则。注意它会返回1
对于具有__getitem__()
方法,除非dict
子类,因为在一般情况下,不可能确定它支持的键的类型。此函数总是成功的。
-
Py_ssize_t PySequence_Size(PyObject *o)¶
-
Py_ssize_t PySequence_Length(PyObject *o)¶
按顺序返回对象数 o 论成功
-1
失败论。这相当于python表达式len(o)
.
-
PyObject *PySequence_Concat(PyObject *o1, PyObject *o2)¶
- Return value: New reference.
返回的串联 o1 和 o2 论成功
NULL
失败论。这相当于python表达式o1 + o2
.
-
PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count)¶
- Return value: New reference.
Return the result of repeating sequence object o count times, or
NULL
on failure. This is the equivalent of the Python expressiono * count
.
-
PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)¶
- Return value: New reference.
返回的串联 o1 和 o2 论成功
NULL
失败论。操作已完成 in-place 什么时候? o1 支持它。这相当于python表达式o1 += o2
.
-
PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)¶
- Return value: New reference.
Return the result of repeating sequence object o count times, or
NULL
on failure. The operation is done in-place when o supports it. This is the equivalent of the Python expressiono *= count
.
-
PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i)¶
- Return value: New reference.
返回 i 钍元素 o 或
NULL
失败论。这相当于python表达式o[i]
.
-
PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)¶
- Return value: New reference.
返回序列对象的切片 o 之间 i1 和 i2 或
NULL
失败论。这相当于python表达式o[i1:i2]
.
-
int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)¶
分配对象 v 到 ith 元素 o . 引发异常并返回
-1
失败时;返回0
论成功。这相当于python语句o[i] = v
. 这个函数 不 窃取对的引用 v .如果 v 是
NULL
,元素将被删除,但不赞成使用此功能,而赞成使用PySequence_DelItem()
.
-
int PySequence_DelItem(PyObject *o, Py_ssize_t i)¶
删除 i 对象的第个元素 o . 返回
-1
失败论。这相当于python语句del o[i]
.
-
int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)¶
分配序列对象 v 到“按顺序切片”对象 o 从 i1 到 i2 . 这相当于python语句
o[i1:i2] = v
.
-
int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)¶
删除序列中的切片对象 o 从 i1 到 i2 . 返回
-1
失败论。这相当于python语句del o[i1:i2]
.
-
Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)¶
返回出现的次数 value 在里面 o ,即返回
o[key] == value
. 失败时返回-1
. 这相当于python表达式o.count(value)
.
-
int PySequence_Contains(PyObject *o, PyObject *value)¶
确定是否 o 包含 value . 如果一个项目 o 等于 value 返回
1
,否则返回0
. 出错时返回-1
. 这相当于python表达式value in o
.
-
Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)¶
返回第一个索引 i 为此
o[i] == value
. 出错时返回-1
.这相当于python表达式o.index(value)
.
-
PyObject *PySequence_List(PyObject *o)¶
- Return value: New reference.
返回与序列或ITerable内容相同的列表对象 o 或
NULL
失败时。返回的列表保证是新的。这相当于python表达式list(o)
.
-
PyObject *PySequence_Tuple(PyObject *o)¶
- Return value: New reference.
返回与sequence或iterable内容相同的tuple对象 o 或
NULL
失败论。如果 o 是一个元组,将返回一个新的引用,否则将使用适当的内容构造一个元组。这相当于python表达式tuple(o)
.
-
PyObject *PySequence_Fast(PyObject *o, const char *m)¶
- Return value: New reference.
返回序列或iterable o 作为另一方可用的对象
PySequence_Fast*
功能系列。如果对象不是序列或iterable,则引发TypeError
具有 m 作为消息文本。退换商品NULL
失败论。这个
PySequence_Fast*
因此命名函数是因为它们假定 o 是一个PyTupleObject
或APyListObject
并访问 o 直接。作为CPython实现细节,如果 o 已经是序列或列表,将返回。
-
Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)¶
返回的长度 o 假设 o 被归还
PySequence_Fast()
那 o 不是NULL
. 也可以通过调用PySequence_Size()
在 o ,但是PySequence_Fast_GET_SIZE()
更快,因为它可以假设 o 是列表或元组。
-
PyObject *PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)¶
- Return value: Borrowed reference.
返回 i 钍元素 o 假设 o 被归还
PySequence_Fast()
, o 不是NULL
那 i 在范围内。
-
PyObject **PySequence_Fast_ITEMS(PyObject *o)¶
返回PyObject指针的基础数组。假设 o 被归还
PySequence_Fast()
和 o 不是NULL
.注意,如果列表调整了大小,重新分配可能会重新定位items数组。因此,只能在序列无法更改的上下文中使用基础数组指针。
-
PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)¶
- Return value: New reference.
返回 i 钍元素 o 或
NULL
失败时。更快的形式PySequence_GetItem()
但不检查那个PySequence_Check()
在 o 为真,不调整负指数。