Протокол последовательности¶

int PySequence_Check(PyObject *o)¶

Part of the Стабильный ABI.

Возвращает 1, если объект предоставляет протокол последовательности, и 0 в противном случае. Обратите внимание, что она возвращает 1 для классов Python с методом __getitem__(), если только они не являются подклассами dict, поскольку в общем случае невозможно определить, какой тип ключей поддерживает класс. Эта функция всегда выполняется успешно.

Py_ssize_t PySequence_Size(PyObject *o)¶

Py_ssize_t PySequence_Length(PyObject *o)¶

Part of the Стабильный ABI.

Возвращает количество объектов в последовательности o в случае успеха и -1 в случае неудачи. Это эквивалентно выражению Python len(o).

PyObject *PySequence_Concat(PyObject *o1, PyObject *o2)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает объединение o1 и o2 в случае успеха и NULL в случае неудачи. Это эквивалент выражения Python o1 + o2.

PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает результат повторения объекта sequence o count раз или NULL в случае сбоя. Это эквивалент выражения Python o * count.

PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает объединение o1 и o2 в случае успеха и NULL в случае неудачи. Операция выполняется на месте, если o1 поддерживает ее. Это эквивалент выражения Python o1 += o2.

PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает результат повторения объекта sequence o*количество раз или ``NULL`` в случае сбоя. Операция выполняется *на месте, если o поддерживает ее. Это эквивалент выражения Python o *= count.

PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает i-й элемент из o или NULL в случае сбоя. Это эквивалент выражения Python o[i].

PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает фрагмент объекта sequence o между i1 и i2 или NULL в случае сбоя. Это эквивалент выражения Python o[i1:i2].

int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)¶

Part of the Стабильный ABI.

Назначьте объект v i-му элементу o. Вызовите исключение и верните -1 в случае сбоя; верните 0 в случае успеха. Это эквивалентно инструкции Python o[i] = v. Эта функция не крадет ссылку на v.

Если v равно NULL, элемент удаляется, но эта функция считается устаревшей в пользу использования PySequence_DelItem().

int PySequence_DelItem(PyObject *o, Py_ssize_t i)¶

Part of the Стабильный ABI.

Удалите i-й элемент object o. В случае сбоя возвращает -1. Это эквивалентно инструкции Python del o[i].

int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)¶

Part of the Стабильный ABI.

Присвойте объект последовательности v фрагменту в объекте последовательности o от i1 до i2. Это эквивалентно инструкции Python o[i1:i2] = v.

int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)¶

Part of the Стабильный ABI.

Удалите фрагмент в объекте последовательности o от i1 до i2. В случае сбоя возвращает -1. Это эквивалентно инструкции Python del o[i1:i2].

Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)¶

Part of the Стабильный ABI.

Возвращает количество вхождений value в o, то есть возвращает количество ключей, для которых o[key] == value. В случае сбоя возвращает -1. Это эквивалентно выражению Python o.count(value).

int PySequence_Contains(PyObject *o, PyObject *value)¶

Part of the Стабильный ABI.

Определите, содержит ли o значение. Если элемент в o равен value, верните 1, в противном случае верните 0. В случае ошибки верните -1. Это эквивалентно выражению Python value in o.

Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)¶

Part of the Стабильный ABI.

Возвращает первый индекс i, для которого o[i] == value. В случае ошибки возвращает -1. Это эквивалентно выражению Python o.index(value).

PyObject *PySequence_List(PyObject *o)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает объект list с тем же содержимым, что и sequence или iterable o, или NULL в случае сбоя. Гарантированно, что возвращаемый список будет новым. Это эквивалентно выражению Python list(o).

PyObject *PySequence_Tuple(PyObject *o)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает объект tuple с тем же содержимым, что и sequence или iterable o, или NULL в случае сбоя. Если o является кортежем, будет возвращена новая ссылка, в противном случае будет создан кортеж с соответствующим содержимым. Это эквивалентно выражению Python tuple(o).

PyObject *PySequence_Fast(PyObject *o, const char *m)¶

Возвращаемое значение: Новая ссылка. Part of the Стабильный ABI.

Возвращает последовательность или итерацию o в качестве объекта, используемого другим семейством функций PySequence_Fast*. Если объект не является последовательностью или итерацией, вызывает TypeError с m в качестве текста сообщения. Возвращает NULL при сбое.

Функции PySequence_Fast* названы таким образом, потому что они предполагают, что o - это a PyTupleObject или a PyListObject и получают прямой доступ к полям данных 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)¶

Возвращаемое значение: Заимствованная ссылка.

Возвращает i-й элемент o, предполагая, что o был возвращен с помощью PySequence_Fast(), o не является NULL и что i находится в пределах допустимых значений.

PyObject **PySequence_Fast_ITEMS(PyObject *o)¶

Возвращает базовый массив указателей на PyObject. Предполагается, что o было возвращено с помощью PySequence_Fast(), а o не является NULL.

Обратите внимание, что при изменении размера списка при перераспределении может произойти перемещение массива элементов. Поэтому используйте указатель на базовый массив только в тех контекстах, где последовательность не может измениться.

PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)¶

Возвращаемое значение: Новая ссылка.

Возвращает i-й элемент из o или NULL в случае сбоя. Более быстрая форма PySequence_GetItem(), но без проверки того, что PySequence_Check() на o является истинным и без корректировки на отрицательные индексы.