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

int PySequence_Check(PyObject *o)

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

Возвращает 1, если объект поддерживает протокол последовательности, и 0 в противном случае. Обратите внимание, что для классов Python с методом __getitem__() возвращается 1, если только они не являются подклассами 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.

int PySequence_In(PyObject *o, PyObject *value)

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

Псевдоним для PySequence_Contains().

Не рекомендуется к использованию начиная с версии 3.14: Эту функцию больше не следует использовать при написании нового кода.

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. Размер также можно получить, вызвав для o функцию PySequence_Size(), однако 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(), но без проверки того, что для o выполняется PySequence_Check(), и без корректировки отрицательных индексов.