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

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

Py_ssize_t PySequence_Size(PyObject *o)
Py_ssize_t PySequence_Length(PyObject *o): Часть Стабильной ABI.
Возвращает количество объектов в последовательности o при успешном выполнении и -1 при ошибке. Это эквивалентно выражению Python len(o).

PyObject *PySequence_Concat(PyObject *o1, PyObject *o2): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает конкатенацию o1 и o2 при успешном выполнении и NULL при ошибке. Это эквивалентно выражению Python o1 + o2.

PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает результат повторения объекта последовательности o count раз или NULL при ошибке. Это эквивалентно выражению Python o * count.

PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает конкатенацию o1 и o2 при успешном выполнении и NULL при ошибке. Операция выполняется на месте, если o1 её поддерживает. Это эквивалентно выражению Python o1 += o2.

PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает результат повторения объекта последовательности o count раз или NULL при ошибке. Операция выполняется на месте, если o её поддерживает. Это эквивалентно выражению Python o *= count.

PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает i-й элемент o или NULL при ошибке. Это эквивалентно выражению Python o[i].

PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает срез объекта последовательности o между i1 и i2 или NULL при ошибке. Это эквивалентно выражению Python o[i1:i2].

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

Часть Стабильной ABI.

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

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

int PySequence_DelItem(PyObject *o, Py_ssize_t i): Часть Стабильной ABI.
Удаляет i-й элемент объекта o. Возвращает -1 при ошибке. Это эквивалентно оператору Python del o[i].

int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v): Часть Стабильной ABI.
Присваивает объект v срезу объекта последовательности o от i1 до i2. Это эквивалентно оператору Python o[i1:i2] = v.

int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2): Часть Стабильной ABI.
Удаляет срез в объекте последовательности o от i1 до i2. Возвращает -1 при ошибке. Это эквивалентно оператору Python del o[i1:i2].

Py_ssize_t PySequence_Count(PyObject *o, PyObject *value): Часть Стабильной ABI.
Возвращает количество вхождений value в o, то есть количество ключей, для которых o[key] == value. При ошибке возвращает -1. Это эквивалентно выражению Python o.count(value).

int PySequence_Contains(PyObject *o, PyObject *value): Часть Стабильной ABI.
Определяет, содержит ли o значение value. Если элемент в o равен value, возвращает 1, в противном случае 0. При ошибке возвращает -1. Это эквивалентно выражению Python value in o.

Py_ssize_t PySequence_Index(PyObject *o, PyObject *value): Часть Стабильной ABI.
Возвращает первый индекс i, для которого o[i] == value. При ошибке возвращает -1. Это эквивалентно выражению Python o.index(value).

PyObject *PySequence_List(PyObject *o): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает объект списка с теми же содержимым, что и последовательность или итерируемый объект o, или NULL при ошибке. Возвращаемый список гарантированно является новым. Это эквивалентно выражению Python list(o).

PyObject *PySequence_Tuple(PyObject *o): Возвращаемое значение: Новая ссылка. Часть Стабильной ABI.
Возвращает кортеж с тем же содержимым, что и последовательность или итерируемый объект o, или NULL при ошибке. Если o — кортеж, возвращается новая ссылка, в противном случае строится кортеж с соответствующим содержимым. Это эквивалентно выражению Python tuple(o).

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

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

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

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

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

END_OF_DOCUMENT_MARKER

PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i): Возвращаемое значение: Новая ссылка.
Возвращает i-й элемент o или NULL при ошибке. Более быстрый вариант PySequence_GetItem(), но без проверки, что PySequence_Check() для o истинно и без корректировки для отрицательных индексов.