`sequence.md`

314 строк · 13.3 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.0/c-api/sequence.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол последовательности89**\[PySequence\_Check\]int `PySequence_Check`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**1011Возвращает1213`1`1415, если объект поддерживает протокол последовательности, и1617`0`1819в противном случае. Эта функция всегда завершается успешно.2021**\[PySequence\_Size\]Py\_ssize\_t `PySequence_Size`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**2223Возвращает количество объектов в последовательности *o* в случае успеха и `-1` в случае ошибки. Для объектов, не поддерживающих протокол последовательности, эта функция эквивалентна выражению Python `len(o)`.2425**\[PySequence\_Length\]Py\_ssize\_t `PySequence_Length`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**2627Альтернативное имя для2829[`PySequence_Size`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Size)3031.3233**\[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*)**3435*Возвращаемое значение: новая ссылка.*3637Возвращает конкатенацию *o1* и *o2* в случае успеха и *NULL* в случае ошибки. Это эквивалент выражения Python `o1 + o2`.3839**\[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*)**4041*Возвращаемое значение: новая ссылка.*4243Возвращает результат повторения объекта-последовательности *o* *count* раз или *NULL* в случае ошибки. Это эквивалент выражения Python `o * count`.4445**\[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*)**4647*Возвращаемое значение: новая ссылка.*4849Возвращает конкатенацию *o1* и *o2* в случае успеха и *NULL* в случае ошибки. Операция выполняется *на месте*, если *o1* это поддерживает. Это эквивалент выражения Python `o1 += o2`.5051**\[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*)**5253*Возвращаемое значение: новая ссылка.*5455Возвращает результат повторения объекта-последовательности *o* *count* раз или *NULL* в случае ошибки. Операция выполняется *на месте*, если *o* это поддерживает. Это эквивалент выражения Python `o *= count`.5657**\[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*)**5859*Возвращаемое значение: новая ссылка.*6061Возвращает *i-й элемент \*o* или *NULL* при ошибке. Это эквивалент выражения Python `o[i]`.6263**\[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*)**6465*Возвращаемое значение: новая ссылка.*6667Возвращает срез объекта-последовательности *o* между *i1* и *i2* или *NULL* в случае ошибки. Это эквивалент выражения Python `o[i1:i2]`.6869**\[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*)**7071Присваивает объект7273*v*7475*i-му элементу \*o*7677. Возвращает7879`-1`8081при ошибке. Это эквивалент оператора Python8283`o[i] = v`8485. Эта функция8687*не*8889крадёт ссылку на9091*v*9293.9495**\[PySequence\_DelItem\]int `PySequence_DelItem`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**9697Удаляет9899*i-й элемент объекта \*o*100101. Возвращает102103`-1`104105при ошибке. Это эквивалент оператора Python106107`del o[i]`108109.110111**\[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*)**112113Присваивает объект-последовательность114115*v*116117срезу объекта-последовательности118119*o*120121от122123*i1*124125до126127*i2*128129. Это эквивалент оператора Python130131`o[i1:i2] = v`132133.134135**\[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*)**136137Удаляет срез объекта-последовательности138139*o*140141от142143*i1*144145до146147*i2*148149. Возвращает150151`-1`152153в случае ошибки. Это эквивалент оператора Python154155`del o[i1:i2]`156157.158159**\[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*)**160161Возвращает количество вхождений162163*value*164165в166167*o*168169, то есть количество ключей, для которых выполняется условие170171`o[key] == value`172173. В случае ошибки возвращает174175`-1`176177. Это эквивалент выражения Python178179`o.count(value)`180181.182183**\[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*)**184185Определяет, содержит ли186187*o*188189значение190191*value*192193. Если элемент194195*o*196197равен198199*value*200201, возвращает202203`1`204205, в противном случае возвращает206207`0`208209. При ошибке возвращает210211`-1`212213. Это эквивалент выражения Python214215`value in o`216217.218219**\[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*)**220221Возвращает первый индекс222223*i*224225, для которого выполняется условие226227`o[i] == value`228229. При ошибке возвращает230231`-1`232233. Это эквивалент выражения Python234235`o.index(value)`236237.238239**\[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*)**240241*Возвращаемое значение: новая ссылка.*242243Возвращает объект списка с тем же содержимым, что и произвольная последовательность *o*. Гарантируется, что возвращённый список является новым.244245**\[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*)**246247*Возвращаемое значение: новая ссылка.*248249Возвращает объект кортежа с тем же содержимым, что и произвольная последовательность *o*, или *NULL* в случае ошибки. Если *o* уже является кортежем, будет возвращена новая ссылка; в противном случае будет создан кортеж с соответствующим содержимым. Это эквивалентно выражению Python `tuple(o)`.250251**\[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*)**252253*Возвращаемое значение: новая ссылка.*254255Возвращает последовательность *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* в качестве сообщения.256257**\[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*)**258259*Возвращаемое значение: заимствованная ссылка.*260261Возвращает *i-й элемент \*o* при условии, что *o* был возвращён [`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast), *o* не равен *NULL*, и *i* находится в допустимых пределах.262263**\[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*)**264265Возвращает внутренний массив указателей на PyObject. Предполагается, что *o* был возвращён [`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast) и *o* не равен *NULL*.266267Примечание: если список изменяет размер, перераспределение может переместить массив элементов. Поэтому используйте указатель на внутренний массив только в контекстах, где последовательность не может измениться.268269**\[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*)**270271*Возвращаемое значение: новая ссылка.*272273Возвращает *i-й элемент \*o* или *NULL* при ошибке. Макроформа [`PySequence_GetItem`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_GetItem), но без проверки того, что `PySequence_Check(o)` истинно, и без корректировки для отрицательных индексов.274275**\[PySequence\_Fast\_GET\_SIZE\]Py\_ssize\_t `PySequence_Fast_GET_SIZE`([PyObject](https://python-all.ru/3.0/c-api/structures.html#PyObject) *\*o*)**276277Возвращает длину278279*o*280281, при условии, что282283*o*284285был возвращён286287[`PySequence_Fast`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast)288289и290291*o*292293не равен294295*NULL*296297. Размер также можно получить, вызвав298299[`PySequence_Size`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Size)300301для302303*o*304305, но306307[`PySequence_Fast_GET_SIZE`](https://python-all.ru/3.0/c-api/sequence.html#PySequence_Fast_GET_SIZE)308309работает быстрее, так как может считать, что310311*o*312313является списком или кортежем.314