`sequence.md`

172 строк · 13.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.15/c-api/sequence.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол последовательности89#### `int PySequence_Check(PyObject *o)`1011*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*1213Возвращает `1`, если объект поддерживает протокол последовательности, и `0` в противном случае. Обратите внимание, что функция возвращает `1` для классов Python с методом [`__getitem__()`](https://python-all.ru/3.15/reference/datamodel.html#object.__getitem__), если только они не являются подклассами [`dict`](https://python-all.ru/3.15/library/stdtypes.html#dict), поскольку в общем случае невозможно определить, какой тип ключей поддерживает класс. Эта функция всегда завершается успешно.1415#### `Py_ssize_t PySequence_Size(PyObject *o)`1617#### `Py_ssize_t PySequence_Length(PyObject *o)`1819*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*2021Возвращает количество объектов в последовательности *o* в случае успеха и `-1` при неудаче. Эквивалентно выражению Python `len(o)`.2223#### `PyObject *PySequence_Concat(PyObject *o1, PyObject *o2)`2425*Возвращаемое значение: новая ссылка.*2627*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*2829Возвращает конкатенацию *o1* и *o2* в случае успеха и `NULL` при неудаче. Эквивалентно выражению Python `o1 + o2`.3031#### `PyObject *PySequence_Repeat(PyObject *o, Py_ssize_t count)`3233*Возвращаемое значение: новая ссылка.*3435*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*3637Возвращает результат повторения объекта последовательности *o* *count* раз или `NULL` при неудаче. Эквивалентно выражению Python `o * count`.3839#### `PyObject *PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)`4041*Возвращаемое значение: новая ссылка.*4243*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*4445Возвращает конкатенацию *o1* и *o2* в случае успеха и `NULL` при неудаче. Операция выполняется *на месте*, если *o1* это поддерживает. Эквивалентно выражению Python `o1 += o2`.4647#### `PyObject *PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)`4849*Возвращаемое значение: новая ссылка.*5051*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*5253Возвращает результат повторения объекта последовательности *o* *count* раз или `NULL` при неудаче. Операция выполняется *на месте*, если *o* это поддерживает. Эквивалентно выражению Python `o *= count`.5455#### `PyObject *PySequence_GetItem(PyObject *o, Py_ssize_t i)`5657*Возвращаемое значение: новая ссылка.*5859*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*6061Возвращает элемент с индексом *i* объекта *o* или `NULL` при неудаче. Эквивалентно выражению Python `o[i]`.6263#### `PyObject *PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)`6465*Возвращаемое значение: новая ссылка.*6667*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*6869Возвращает срез объекта последовательности *o* между *i1* и *i2* или `NULL` при неудаче. Эквивалентно выражению Python `o[i1:i2]`.7071#### `int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)`7273*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*7475Присваивает объект *v* элементу с индексом *i* объекта *o*. Возбуждает исключение и возвращает `-1` при неудаче; возвращает `0` в случае успеха. Эквивалентно инструкции Python `o[i] = v`. Эта функция *не* «[забирает](https://python-all.ru/3.15/glossary.html#term-steal)» ссылку на *v*.7677Если *v* равно `NULL`, элемент удаляется, но эта возможность устарела; рекомендуется использовать [`PySequence_DelItem()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_DelItem).7879#### `int PySequence_DelItem(PyObject *o, Py_ssize_t i)`8081*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*8283Удаляет элемент с индексом *i* объекта *o*. Возвращает `-1` при неудаче. Эквивалентно инструкции Python `del o[i]`.8485#### `int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)`8687*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*8889Присваивает объект последовательности *v* срезу в объекте последовательности *o* от *i1* до *i2*. Эквивалентно инструкции Python `o[i1:i2] = v`.9091#### `int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)`9293*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*9495Удаляет срез в объекте последовательности *o* от *i1* до *i2*. Возвращает `-1` при неудаче. Эквивалентно инструкции Python `del o[i1:i2]`.9697#### `Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)`9899*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*100101Возвращает количество вхождений *value* в *o*, то есть количество ключей, для которых `o[key] == value`. При неудаче возвращает `-1`. Эквивалентно выражению Python `o.count(value)`.102103#### `int PySequence_Contains(PyObject *o, PyObject *value)`104105*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*106107Определяет, содержит ли *o* значение *value*. Если элемент в *o* равен *value*, возвращает `1`, иначе возвращает `0`. При ошибке возвращает `-1`. Эквивалентно выражению Python `value in o`.108109#### `int PySequence_In(PyObject *o, PyObject *value)`110111*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*112113Псевдоним для [`PySequence_Contains()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Contains).114115[Мягко устарело](https://python-all.ru/3.15/glossary.html#term-soft-deprecated) с версии 3.14: Эту функцию больше не следует использовать для написания нового кода.116117#### `Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)`118119*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*120121Возвращает первый индекс *i*, для которого `o[i] == value`. При ошибке возвращает `-1`. Это эквивалентно выражению Python `o.index(value)`.122123#### `PyObject *PySequence_List(PyObject *o)`124125*Возвращаемое значение: новая ссылка.*126127*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*128129Возвращает список с тем же содержимым, что и последовательность или итерируемый объект *o*, или `NULL` при ошибке. Возвращённый список гарантированно новый. Это эквивалентно выражению Python `list(o)`.130131#### `PyObject *PySequence_Tuple(PyObject *o)`132133*Возвращаемое значение: новая ссылка.*134135*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*136137Возвращает кортеж с тем же содержимым, что и последовательность или итерируемый объект *o*, или `NULL` при ошибке. Если *o* уже является кортежем, возвращается новая ссылка, иначе будет создан кортеж с соответствующим содержимым. Это эквивалентно выражению Python `tuple(o)`.138139#### `PyObject *PySequence_Fast(PyObject *o, const char *m)`140141*Возвращаемое значение: новая ссылка.*142143*Часть [Stable ABI](https://python-all.ru/3.15/c-api/stable.html#stable).*144145Возвращает последовательность или итерируемый объект *o* в виде объекта, пригодного для использования другими функциями семейства `PySequence_Fast*`. Если объект не является последовательностью или итерируемым объектом, возбуждается [`TypeError`](https://python-all.ru/3.15/library/exceptions.html#TypeError) с текстом сообщения *m*. Возвращает `NULL` при ошибке.146147Функции `PySequence_Fast*` названы так, потому что они предполагают, что *o* является [`PyTupleObject`](https://python-all.ru/3.15/c-api/tuple.html#c.PyTupleObject) или [`PyListObject`](https://python-all.ru/3.15/c-api/list.html#c.PyListObject) и обращаются к полям данных *o* напрямую.148149В рамках реализации CPython: если *o* уже является последовательностью или списком, он будет возвращён.150151#### `Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)`152153Возвращает длину *o*, предполагая, что *o* была возвращена [`PySequence_Fast()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Fast) и что *o* не является `NULL`. Длину также можно получить, вызвав [`PySequence_Size()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Size) для *o*, но [`PySequence_Fast_GET_SIZE()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Fast_GET_SIZE) быстрее, так как может предполагать, что *o* является списком или кортежем.154155#### `PyObject *PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)`156157*Возвращаемое значение: заимствованная ссылка.*158159Возвращает *i*-й элемент *o*, предполагая, что *o* был возвращён [`PySequence_Fast()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Fast), *o* не является `NULL`, и *i* находится в допустимых пределах.160161#### `PyObject **PySequence_Fast_ITEMS(PyObject *o)`162163Возвращает внутренний массив указателей PyObject. Предполагается, что *o* был возвращён [`PySequence_Fast()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Fast) и *o* не является `NULL`.164165Примечание: если список изменяет размер, перераспределение может переместить массив элементов. Поэтому используйте указатель на внутренний массив только в контекстах, где последовательность не может измениться.166167#### `PyObject *PySequence_ITEM(PyObject *o, Py_ssize_t i)`168169*Возвращаемое значение: новая ссылка.*170171Возвращает *i*-й элемент *o* или `NULL` при ошибке. Более быстрая версия [`PySequence_GetItem()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_GetItem), но без проверки того, что [`PySequence_Check()`](https://python-all.ru/3.15/c-api/sequence.html#c.PySequence_Check) для *o* равно true, и без коррекции для отрицательных индексов.172