`list.md`

126 строк · 8.7 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.11/c-api/list.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# Объекты списков89#### `type PyListObject`1011Этот подтип [`PyObject`](https://python-all.ru/3.11/c-api/structures.html#c.PyObject) представляет объект списка Python.1213#### `PyTypeObject PyList_Type`1415*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*1617Этот экземпляр [`PyTypeObject`](https://python-all.ru/3.11/c-api/type.html#c.PyTypeObject) представляет тип списка Python. Это тот же объект, что и [`list`](https://python-all.ru/3.11/library/stdtypes.html#list) в слое Python.1819#### `int PyList_Check(PyObject *p)`2021Возвращает true, если *p* является объектом списка или экземпляром подтипа типа списка. Эта функция всегда завершается успешно.2223#### `int PyList_CheckExact(PyObject *p)`2425Возвращает true, если *p* является объектом списка, но не экземпляром подтипа типа списка. Эта функция всегда завершается успешно.2627#### `PyObject *PyList_New(Py_ssize_t len)`2829*Возвращаемое значение: новая ссылка.*3031*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*3233Возвращает новый список длины *len* в случае успеха или `NULL` в случае ошибки.3435> **Примечание**36>37> Если *len* больше нуля, элементы возвращаемого объекта списка устанавливаются в `NULL`. Поэтому нельзя использовать функции абстрактного API, такие как [`PySequence_SetItem()`](https://python-all.ru/3.11/c-api/sequence.html#c.PySequence_SetItem) или передавать объект коду Python до того, как все элементы будут установлены в реальные объекты с помощью [`PyList_SetItem()`](https://python-all.ru/3.11/c-api/list.html#c.PyList_SetItem).3839#### `Py_ssize_t PyList_Size(PyObject *list)`4041*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*4243Возвращает длину объекта списка в *list*; это эквивалентно `len(list)` для объекта списка.4445#### `Py_ssize_t PyList_GET_SIZE(PyObject *list)`4647Аналогично [`PyList_Size()`](https://python-all.ru/3.11/c-api/list.html#c.PyList_Size), но без проверки ошибок.4849#### `PyObject *PyList_GetItem(PyObject *list, Py_ssize_t index)`5051*Возвращаемое значение: заимствованная ссылка.*5253*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*5455Возвращает объект по позиции *index* в списке, на который указывает *list*. Позиция должна быть неотрицательной; индексация с конца списка не поддерживается. Если *index* выходит за границы (\<0 или \>=len(list)), возвращается `NULL` и устанавливается исключение [`IndexError`](https://python-all.ru/3.11/library/exceptions.html#IndexError).5657#### `PyObject *PyList_GET_ITEM(PyObject *list, Py_ssize_t i)`5859*Возвращаемое значение: заимствованная ссылка.*6061Аналогично [`PyList_GetItem()`](https://python-all.ru/3.11/c-api/list.html#c.PyList_GetItem), но без проверки ошибок.6263#### `int PyList_SetItem(PyObject *list, Py_ssize_t index, PyObject *item)`6465*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*6667Устанавливает элемент на индексе *index* в списке в значение *item*. Возвращает `0` в случае успеха. Если *index* выходит за границы, возвращает `-1` и устанавливает исключение [`IndexError`](https://python-all.ru/3.11/library/exceptions.html#IndexError).6869> **Примечание**70>71> Эта функция «забирает» ссылку на *item* и отбрасывает ссылку на элемент, уже находящийся в списке на затрагиваемой позиции.7273#### `void PyList_SET_ITEM(PyObject *list, Py_ssize_t i, PyObject *o)`7475Макро-форма [`PyList_SetItem()`](https://python-all.ru/3.11/c-api/list.html#c.PyList_SetItem) без проверки ошибок. Обычно используется только для заполнения новых списков, где нет предыдущего содержимого.7677> **Примечание**78>79> Этот макрос «забирает» ссылку на *item* и, в отличие от [`PyList_SetItem()`](https://python-all.ru/3.11/c-api/list.html#c.PyList_SetItem), *не* отбрасывает ссылку на заменяемый элемент; любая ссылка в *list* на позиции *i* будет утеряна (приведёт к утечке).8081#### `int PyList_Insert(PyObject *list, Py_ssize_t index, PyObject *item)`8283*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*8485Вставляет элемент *item* в список *list* перед индексом *index*. Возвращает `0` при успехе; возвращает `-1` и устанавливает исключение при неудаче. Аналогично `list.insert(index, item)`.8687#### `int PyList_Append(PyObject *list, PyObject *item)`8889*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*9091Добавляет объект *item* в конец списка *list*. Возвращает `0` при успехе; возвращает `-1` и устанавливает исключение при неудаче. Аналогично `list.append(item)`.9293#### `PyObject *PyList_GetSlice(PyObject *list, Py_ssize_t low, Py_ssize_t high)`9495*Возвращаемое значение: новая ссылка.*9697*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*9899Возвращает список объектов из *list*, содержащий объекты *между* *low* и *high*. Возвращает `NULL` и устанавливает исключение при неудаче. Аналогично `list[low:high]`. Индексация с конца списка не поддерживается.100101#### `int PyList_SetSlice(PyObject *list, Py_ssize_t low, Py_ssize_t high, PyObject *itemlist)`102103*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*104105Устанавливает срез *list* между *low* и *high* равным содержимому *itemlist*. Аналогично `list[low:high] = itemlist`. *itemlist* может быть `NULL`, что означает присваивание пустого списка (удаление среза). Возвращает `0` при успехе, `-1` при неудаче. Индексация с конца списка не поддерживается.106107#### `int PyList_Sort(PyObject *list)`108109*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*110111Сортирует элементы *list* на месте. Возвращает `0` при успехе, `-1` при неудаче. Эквивалентно `list.sort()`.112113#### `int PyList_Reverse(PyObject *list)`114115*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*116117Разворачивает элементы *list* на месте. Возвращает `0` при успехе, `-1` при неудаче. Эквивалентно `list.reverse()`.118119#### `PyObject *PyList_AsTuple(PyObject *list)`120121*Возвращаемое значение: новая ссылка.*122123*Часть [Stable ABI](https://python-all.ru/3.11/c-api/stable.html#stable).*124125Возвращает новый объект кортежа, содержащий содержимое *list*; эквивалентно `tuple(list)`.126