> **Источник:** https://python-all.ru/3.0/c-api/sequence.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

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

**\[PySequence\_Check\]int `PySequence_Check`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

Возвращает

`1`

, если объект поддерживает протокол последовательности, и

`0`

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

**\[PySequence\_Size\]Py\_ssize\_t `PySequence_Size`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

Возвращает количество объектов в последовательности *o* в случае успеха и `-1` в случае ошибки. Для объектов, не поддерживающих протокол последовательности, эта функция эквивалентна выражению Python `len(o)`.

**\[PySequence\_Length\]Py\_ssize\_t `PySequence_Length`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

Альтернативное имя для

[`PySequence_Size`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Size)

.

**\[PySequence\_Concat\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_Concat`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o1*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o2*)**

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

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

**\[PySequence\_Repeat\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_Repeat`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *count*)**

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

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

**\[PySequence\_InPlaceConcat\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_InPlaceConcat`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o1*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o2*)**

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

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

**\[PySequence\_InPlaceRepeat\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_InPlaceRepeat`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *count*)**

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

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

**\[PySequence\_GetItem\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_GetItem`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**

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

Возвращает *i-й элемент \*o* или *NULL* при ошибке. Это эквивалент выражения Python `o[i]`.

**\[PySequence\_GetSlice\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_GetSlice`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*)**

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

Возвращает срез объекта-последовательности *o* между *i1* и *i2* или *NULL* в случае ошибки. Это эквивалент выражения Python `o[i1:i2]`.

**\[PySequence\_SetItem\]int `PySequence_SetItem`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*v*)**

Присваивает объект

*v*

*i-му элементу \*o*

. Возвращает

`-1`

при ошибке. Это эквивалент оператора Python

`o[i] = v`

. Эта функция

*не*

крадёт ссылку на

*v*

.

**\[PySequence\_DelItem\]int `PySequence_DelItem`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**

Удаляет

*i-й элемент объекта \*o*

. Возвращает

`-1`

при ошибке. Это эквивалент оператора Python

`del o[i]`

.

**\[PySequence\_SetSlice\]int `PySequence_SetSlice`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*v*)**

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

*v*

срезу объекта-последовательности

*o*

от

*i1*

до

*i2*

. Это эквивалент оператора Python

`o[i1:i2] = v`

.

**\[PySequence\_DelSlice\]int `PySequence_DelSlice`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*)**

Удаляет срез объекта-последовательности

*o*

от

*i1*

до

*i2*

. Возвращает

`-1`

в случае ошибки. Это эквивалент оператора Python

`del o[i1:i2]`

.

**\[PySequence\_Count\]Py\_ssize\_t `PySequence_Count`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*value*)**

Возвращает количество вхождений

*value*

в

*o*

, то есть количество ключей, для которых выполняется условие

`o[key] == value`

. В случае ошибки возвращает

`-1`

. Это эквивалент выражения Python

`o.count(value)`

.

**\[PySequence\_Contains\]int `PySequence_Contains`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*value*)**

Определяет, содержит ли

*o*

значение

*value*

. Если элемент

*o*

равен

*value*

, возвращает

`1`

, в противном случае возвращает

`0`

. При ошибке возвращает

`-1`

. Это эквивалент выражения Python

`value in o`

.

**\[PySequence\_Index\]Py\_ssize\_t `PySequence_Index`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*value*)**

Возвращает первый индекс

*i*

, для которого выполняется условие

`o[i] == value`

. При ошибке возвращает

`-1`

. Это эквивалент выражения Python

`o.index(value)`

.

**\[PySequence\_List\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_List`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

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

Возвращает объект списка с тем же содержимым, что и произвольная последовательность *o*. Гарантируется, что возвращённый список является новым.

**\[PySequence\_Tuple\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_Tuple`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

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

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

**\[PySequence\_Fast\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_Fast`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, const char *\*m*)**

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

Возвращает последовательность *o* в виде кортежа, если только она уже не является кортежем или списком; в этом случае возвращается *o*. Используйте [`PySequence_Fast_GET_ITEM`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast_GET_ITEM) для доступа к элементам результата. Возвращает *NULL* при ошибке. Если объект не является последовательностью, возбуждает [`TypeError`](https://python-all.ru/3.0/library/exceptions.html#exceptions.TypeError) с текстом *m* в качестве сообщения.

**\[PySequence\_Fast\_GET\_ITEM\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_Fast_GET_ITEM`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**

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

Возвращает *i-й элемент \*o* при условии, что *o* был возвращён [`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast), *o* не равен *NULL*, и *i* находится в допустимых пределах.

**\[PySequence\_Fast\_ITEMS\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\*\* `PySequence_Fast_ITEMS`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

Возвращает внутренний массив указателей на PyObject. Предполагается, что *o* был возвращён [`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast) и *o* не равен *NULL*.

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

**\[PySequence\_ITEM\][PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject)\* `PySequence_ITEM`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**

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

Возвращает *i-й элемент \*o* или *NULL* при ошибке. Макроформа [`PySequence_GetItem`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_GetItem), но без проверки того, что `PySequence_Check(o)` истинно, и без корректировки для отрицательных индексов.

**\[PySequence\_Fast\_GET\_SIZE\]Py\_ssize\_t `PySequence_Fast_GET_SIZE`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**

Возвращает длину

*o*

, при условии, что

*o*

был возвращён

[`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast)

и

*o*

не равен

*NULL*

. Размер также можно получить, вызвав

[`PySequence_Size`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Size)

для

*o*

, но

[`PySequence_Fast_GET_SIZE`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast_GET_SIZE)

работает быстрее, так как может считать, что

*o*

является списком или кортежем.