`sequence.md`

228 строк · 16.0 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.6/c-api/sequence.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Протокол последовательности89**int `PySequence_Check`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**1011Возвращает1213`1`1415, если объект поддерживает протокол последовательности, и1617`0`1819в противном случае. Эта функция всегда завершается успешно.2021**Py\_ssize\_t `PySequence_Size`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**2223**Py\_ssize\_t `PySequence_Length`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**2425Возвращает количество объектов в последовательности *o* в случае успеха и `-1` в случае ошибки. Для объектов, не поддерживающих протокол последовательности, эта функция эквивалентна выражению Python `len(o)`.2627Изменено в версии 2.5: Эти функции возвращали тип `int`. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.2829**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_Concat`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o1*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o2*)**3031*Возвращаемое значение: новая ссылка.*3233Возвращает конкатенацию *o1* и *o2* в случае успеха и *NULL* в случае ошибки. Это эквивалент выражения Python `o1 + o2`.3435**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_Repeat`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *count*)**3637*Возвращаемое значение: новая ссылка.*3839Возвращает результат повторения объекта-последовательности *o* *count* раз или *NULL* в случае ошибки. Это эквивалент выражения Python `o * count`.4041Изменено в версии 2.5: Эта функция использовала тип `int` для *count*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.4243**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_InPlaceConcat`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o1*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o2*)**4445*Возвращаемое значение: новая ссылка.*4647Возвращает конкатенацию *o1* и *o2* в случае успеха и *NULL* в случае ошибки. Операция выполняется *на месте*, если *o1* это поддерживает. Это эквивалент выражения Python `o1 += o2`.4849**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_InPlaceRepeat`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *count*)**5051*Возвращаемое значение: новая ссылка.*5253Возвращает результат повторения объекта-последовательности *o* *count* раз или *NULL* в случае ошибки. Операция выполняется *на месте*, если *o* это поддерживает. Это эквивалент выражения Python `o *= count`.5455Изменено в версии 2.5: Эта функция использовала тип `int` для *count*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.5657**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_GetItem`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**5859*Возвращаемое значение: новая ссылка.*6061Возвращает *i*-й элемент *o* или *NULL* в случае ошибки. Это эквивалент выражения Python `o[i]`.6263Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.6465**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_GetSlice`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*)**6667*Возвращаемое значение: новая ссылка.*6869Возвращает срез объекта-последовательности *o* между *i1* и *i2* или *NULL* в случае ошибки. Это эквивалент выражения Python `o[i1:i2]`.7071Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.7273**int `PySequence_SetItem`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*v*)**7475Присваивает объект *v* *i*-му элементу *o*. Возвращает `-1` в случае ошибки. Это эквивалент оператора Python `o[i] = v`. Эта функция *не* заимствует ссылку на *v*.7677Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.7879**int `PySequence_DelItem`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**8081Удаляет *i*-й элемент объекта *o*. Возвращает `-1` в случае ошибки. Это эквивалент оператора Python `del o[i]`.8283Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.8485**int `PySequence_SetSlice`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*v*)**8687Присваивает объект-последовательность *v* срезу объекта-последовательности *o* от *i1* до *i2*. Это эквивалент оператора Python `o[i1:i2] = v`.8889Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.9091**int `PySequence_DelSlice`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i1*, Py\_ssize\_t *i2*)**9293Удаляет срез объекта-последовательности *o* от *i1* до *i2*. Возвращает `-1` в случае ошибки. Это эквивалент оператора Python `del o[i1:i2]`.9495Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.9697**Py\_ssize\_t `PySequence_Count`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*value*)**9899Возвращает количество вхождений *value* в *o*, то есть количество ключей, для которых выполняется условие `o[key] == value`. В случае ошибки возвращает `-1`. Это эквивалент выражения Python `o.count(value)`.100101Изменено в версии 2.5: Эта функция возвращала тип `int`. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.102103**int `PySequence_Contains`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*value*)**104105Определяет, содержит ли106107*o*108109значение110111*value*112113. Если элемент114115*o*116117равен118119*value*120121, возвращает122123`1`124125, в противном случае возвращает126127`0`128129. При ошибке возвращает130131`-1`132133. Это эквивалент выражения Python134135`value in o`136137.138139**Py\_ssize\_t `PySequence_Index`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*value*)**140141Возвращает первый индекс *i*, для которого выполняется условие `o[i] == value`. При ошибке возвращает `-1`. Это эквивалент выражения Python `o.index(value)`.142143Изменено в версии 2.5: Эта функция возвращала тип `int`. Это может потребовать изменений в коде для корректной поддержки 64-битных систем.144145**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_List`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**146147*Возвращаемое значение: новая ссылка.*148149Возвращает объект списка с тем же содержимым, что и произвольная последовательность *o*. Гарантируется, что возвращённый список является новым.150151**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_Tuple`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**152153*Возвращаемое значение: новая ссылка.*154155Возвращает объект кортежа с тем же содержимым, что и произвольная последовательность *o*, или *NULL* в случае ошибки. Если *o* уже является кортежем, будет возвращена новая ссылка; в противном случае будет создан кортеж с соответствующим содержимым. Это эквивалентно выражению Python `tuple(o)`.156157**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_Fast`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, const char *\*m*)**158159*Возвращаемое значение: новая ссылка.*160161Возвращает последовательность *o* в виде кортежа, если только она уже не является кортежем или списком – в этом случае возвращается *o*. Для доступа к элементам результата используйте [`PySequence_Fast_GET_ITEM()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Fast_GET_ITEM). В случае ошибки возвращает *NULL*. Если объект не является последовательностью, возбуждает [`TypeError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.TypeError) с текстом сообщения *m*.162163**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_Fast_GET_ITEM`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**164165*Возвращаемое значение: заимствованная ссылка.*166167Возвращает *i*-й элемент *o*, при условии, что *o* был возвращён функцией [`PySequence_Fast()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Fast), *o* не равен *NULL* и *i* находится в допустимых пределах.168169Изменено в версии 2.5: Ранее эта функция использовала тип `int` для *i*. Возможно, потребуется изменить код для корректной поддержки 64-битных систем.170171**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\*\* `PySequence_Fast_ITEMS`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**172173Возвращает базовый массив указателей на PyObject. Предполагается, что *o* был возвращён функцией [`PySequence_Fast()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Fast) и *o* не равен *NULL*.174175Примечание: если список изменяет размер, перераспределение может переместить массив элементов. Поэтому используйте указатель на внутренний массив только в контекстах, где последовательность не может измениться.176177Новое в версии 2.4.178179**[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PySequence_ITEM`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*, Py\_ssize\_t *i*)**180181*Возвращаемое значение: новая ссылка.*182183Возвращает *i*-й элемент *o* или *NULL* при ошибке. Макроформа [`PySequence_GetItem()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_GetItem), но без проверки `PySequence_Check(o)()` и без корректировки для отрицательных индексов.184185Новое в версии 2.3.186187Изменено в версии 2.5: Ранее эта функция использовала тип `int` для *i*. Возможно, потребуется изменить код для корректной поддержки 64-битных систем.188189**Py\_ssize\_t `PySequence_Fast_GET_SIZE`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)**190191Возвращает длину192193*o*194195, при условии, что196197*o*198199был возвращён функцией200201[`PySequence_Fast()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Fast)202203и204205*o*206207не равен208209*NULL*210211. Размер также можно получить, вызвав212213[`PySequence_Size()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Size)214215для216217*o*218219, но220221[`PySequence_Fast_GET_SIZE()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_Fast_GET_SIZE)222223быстрее, поскольку может предполагать, что224225*o*226227является списком или кортежем.228