`sequence.md`

156 строк · 14.2 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/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Возвращает `1`, если объект поддерживает протокол последовательности, и `0` в противном случае. Эта функция всегда завершается успешно.1213#### `Py_ssize_t PySequence_Size(PyObject *o)`1415#### `Py_ssize_t PySequence_Length(PyObject *o)`1617Возвращает количество объектов в последовательности *o* в случае успеха и `-1` при неудаче. Эквивалентно выражению Python `len(o)`.1819Изменено в версии 2.5: Эти функции возвращали тип `int`. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.2021#### `PyObject* PySequence_Concat(PyObject *o1, PyObject *o2)`2223*Возвращаемое значение: новая ссылка.*2425В случае успеха возвращает конкатенацию *o1* и *o2*, а в случае неудачи – *NULL*. Это эквивалентно выражению Python `o1 + o2`.2627#### `PyObject* PySequence_Repeat(PyObject *o, Py_ssize_t count)`2829*Возвращаемое значение: новая ссылка.*3031Возвращает результат повторения объекта последовательности *o* *count* раз или *NULL* в случае неудачи. Это эквивалентно выражению Python `o * count`.3233Изменено в версии 2.5: Эта функция использовала тип `int` для *count*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.3435#### `PyObject* PySequence_InPlaceConcat(PyObject *o1, PyObject *o2)`3637*Возвращаемое значение: новая ссылка.*3839В случае успеха возвращает конкатенацию *o1* и *o2*, а в случае неудачи – *NULL*. Операция выполняется *на месте*, если *o1* это поддерживает. Это эквивалентно выражению Python `o1 += o2`.4041#### `PyObject* PySequence_InPlaceRepeat(PyObject *o, Py_ssize_t count)`4243*Возвращаемое значение: новая ссылка.*4445Возвращает результат повторения объекта последовательности *o* *count* раз или *NULL* в случае неудачи. Операция выполняется *на месте*, если *o* это поддерживает. Это eквивалентно выражению Python `o *= count`.4647Изменено в версии 2.5: Эта функция использовала тип `int` для *count*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.4849#### `PyObject* PySequence_GetItem(PyObject *o, Py_ssize_t i)`5051*Возвращаемое значение: новая ссылка.*5253Возвращает *i*-й элемент *o* или *NULL* в случае неудачи. Это эквивалентно выражению Python `o[i]`.5455Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.5657#### `PyObject* PySequence_GetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)`5859*Возвращаемое значение: новая ссылка.*6061Возвращает срез объекта последовательности *o* между *i1* и *i2* или *NULL* в случае неудачи. Это эквивалентно выражению Python `o[i1:i2]`.6263Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.6465#### `int PySequence_SetItem(PyObject *o, Py_ssize_t i, PyObject *v)`6667Присваивает объект *v* элементу *o* с индексом *i*. В случае ошибки возбуждает исключение и возвращает `-1`; в случае успеха возвращает `0`. Это эквивалент оператора Python `o[i] = v`. Эта функция *не* забирает ссылку на *v*.6869Если *v* равно *NULL*, элемент удаляется, однако эта возможность устарела в пользу использования [`PySequence_DelItem()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_DelItem).7071Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.7273#### `int PySequence_DelItem(PyObject *o, Py_ssize_t i)`7475Удаляет элемент с индексом *i* объекта *o*. Возвращает `-1` при неудаче. Эквивалентно инструкции Python `del o[i]`.7677Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.7879#### `int PySequence_SetSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2, PyObject *v)`8081Присваивает объект последовательности *v* срезу объекта последовательности *o* от *i1* до *i2*. В случае ошибки возбуждает исключение и возвращает `-1`; в случае успеха возвращает `0`. Это эквивалент оператора Python `o[i1:i2] = v`.8283Если *v* равно *NULL*, срез удаляется; однако эта возможность устарела в пользу использования [`PySequence_DelSlice()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_DelSlice).8485Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.8687#### `int PySequence_DelSlice(PyObject *o, Py_ssize_t i1, Py_ssize_t i2)`8889Удаляет срез в объекте последовательности *o* от *i1* до *i2*. Возвращает `-1` при неудаче. Эквивалентно инструкции Python `del o[i1:i2]`.9091Изменено в версии 2.5: Эта функция использовала тип `int` для *i1* и *i2*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.9293#### `Py_ssize_t PySequence_Count(PyObject *o, PyObject *value)`9495Возвращает количество вхождений *value* в *o*, то есть количество ключей, для которых `o[key] == value`. При неудаче возвращает `-1`. Эквивалентно выражению Python `o.count(value)`.9697Изменено в версии 2.5: Эта функция возвращала тип `int`. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.9899#### `int PySequence_Contains(PyObject *o, PyObject *value)`100101Определяет, содержит ли *o* значение *value*. Если элемент в *o* равен *value*, возвращает `1`, иначе возвращает `0`. При ошибке возвращает `-1`. Эквивалентно выражению Python `value in o`.102103#### `Py_ssize_t PySequence_Index(PyObject *o, PyObject *value)`104105Возвращает первый индекс *i*, для которого `o[i] == value`. При ошибке возвращает `-1`. Это эквивалентно выражению Python `o.index(value)`.106107Изменено в версии 2.5: Эта функция возвращала тип `int`. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.108109#### `PyObject* PySequence_List(PyObject *o)`110111*Возвращаемое значение: новая ссылка.*112113Возвращает объект списка с тем же содержимым, что и произвольная последовательность *o*. Гарантируется, что возвращённый список является новым.114115#### `PyObject* PySequence_Tuple(PyObject *o)`116117*Возвращаемое значение: новая ссылка.*118119Возвращает объект-кортеж с тем же содержимым, что и произвольная последовательность *o*, или *NULL* в случае неудачи. Если *o* уже является кортежем, возвращается новая ссылка; в противном случае строится кортеж с соответствующим содержимым. Это эквивалентно выражению Python `tuple(o)`.120121#### `PyObject* PySequence_Fast(PyObject *o, const char *m)`122123*Возвращаемое значение: новая ссылка.*124125Возвращает последовательность *o* в виде списка, если только она уже не является кортежем или списком – в этом случае возвращается *o*. Для доступа к элементам результата используйте [`PySequence_Fast_GET_ITEM()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Fast_GET_ITEM). Возвращает *NULL* в случае неудачи. Если объект не является последовательностью, возбуждает [`TypeError`](https://python-all.ru/2.7/library/exceptions.html#exceptions.TypeError) с *m* в качестве текста сообщения.126127#### `PyObject* PySequence_Fast_GET_ITEM(PyObject *o, Py_ssize_t i)`128129*Возвращаемое значение: заимствованная ссылка.*130131Возвращает *i*-й элемент *o*, предполагая, что *o* был возвращён функцией [`PySequence_Fast()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Fast), *o* не равно *NULL* и что *i* находится в допустимых пределах.132133Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.134135#### `PyObject** PySequence_Fast_ITEMS(PyObject *o)`136137Возвращает внутренний массив указателей PyObject. Предполагается, что *o* был возвращён функцией [`PySequence_Fast()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Fast) и *o* не равно *NULL*.138139Примечание: если список изменяет размер, перераспределение может переместить массив элементов. Поэтому используйте указатель на внутренний массив только в контекстах, где последовательность не может измениться.140141Новое в версии 2.4.142143#### `PyObject* PySequence_ITEM(PyObject *o, Py_ssize_t i)`144145*Возвращаемое значение: новая ссылка.*146147Возвращает *i*-й элемент *o* или *NULL* в случае неудачи. Макроформа [`PySequence_GetItem()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_GetItem), но без проверки того, что [`PySequence_Check()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Check) для *o* истинно, и без корректировки для отрицательных индексов.148149Новое в версии 2.3.150151Изменено в версии 2.5: Эта функция использовала тип `int` для *i*. Возможно, потребуется внести изменения в код для корректной поддержки 64-битных систем.152153#### `Py_ssize_t PySequence_Fast_GET_SIZE(PyObject *o)`154155Возвращает длину *o*, предполагая, что *o* был возвращён функцией [`PySequence_Fast()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Fast) и что *o* не равно *NULL*. Размер также можно получить, вызвав [`PySequence_Size()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Size) для *o*, но [`PySequence_Fast_GET_SIZE()`](https://python-all.ru/2.7/c-api/sequence.html#c.PySequence_Fast_GET_SIZE) работает быстрее, поскольку может предполагать, что *o* является списком или кортежем.156