> **Источник:** https://python-all.ru/2.6/c-api/list.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # Объекты списков **`PyListObject`** Этот подтип [`PyObject`](https://python-all.ru/2.6/c-api/structures.html#PyObject) представляет объект списка Python. **[PyTypeObject](https://python-all.ru/2.6/c-api/type.html#PyTypeObject) `PyList_Type`** Этот экземпляр [`PyTypeObject`](https://python-all.ru/2.6/c-api/type.html#PyTypeObject) представляет тип Python list. Это тот же объект, что и `list` на уровне Python. **int `PyList_Check`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*p*)** Возвращает истину, если *p* является объектом списка или экземпляром подтипа типа list. Изменено в версии 2.2: Теперь допускаются подтипы. **int `PyList_CheckExact`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*p*)** Возвращает истину, если *p* является объектом списка, но не экземпляром подтипа типа list. Новое в версии 2.2. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyList_New`(Py\_ssize\_t *len*)** *Возвращаемое значение: новая ссылка.* Возвращает новый список длины *len* в случае успеха или *NULL* при неудаче. > **Примечание** > > Если *length* больше нуля, элементы возвращаемого списка устанавливаются в `NULL`. Поэтому нельзя использовать абстрактные функции API, такие как [`PySequence_SetItem()`](https://python-all.ru/2.6/c-api/sequence.html#PySequence_SetItem), или передавать этот объект в код Python, пока все элементы не будут установлены в реальные объекты с помощью [`PyList_SetItem()`](https://python-all.ru/2.6/c-api/list.html#PyList_SetItem). Изменено в версии 2.5: Для *size* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **Py\_ssize\_t `PyList_Size`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*)** Возвращает длину объекта списка *list*; это эквивалентно `len(list)` для объекта списка. Изменено в версии 2.5: Эта функция возвращала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **Py\_ssize\_t `PyList_GET_SIZE`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*)** Макроформа [`PyList_Size()`](https://python-all.ru/2.6/c-api/list.html#PyList_Size) без проверки ошибок. Изменено в версии 2.5: Этот макрос возвращал `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyList_GetItem`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *index*)** *Возвращаемое значение: заимствованная ссылка.* Возвращает объект в позиции *pos* списка, на который указывает *p*. Позиция должна быть положительной; индексация с конца списка не поддерживается. Если *pos* выходит за границы, возвращает *NULL* и устанавливает исключение [`IndexError`](https://python-all.ru/2.6/library/exceptions.html#exceptions.IndexError). Изменено в версии 2.5: Для *index* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyList_GET_ITEM`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *i*)** *Возвращаемое значение: заимствованная ссылка.* Макроформа [`PyList_GetItem()`](https://python-all.ru/2.6/c-api/list.html#PyList_GetItem) без проверки ошибок. Изменено в версии 2.5: Для *i* этот макрос использовал `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **int `PyList_SetItem`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *index*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*item*)** Устанавливает элемент с индексом *index* в списке равным *item*. Возвращает `0` в случае успеха или `-1` при неудаче. > **Примечание** > > Эта функция «забирает» ссылку на *item* и отбрасывает ссылку на элемент, уже находящийся в списке на затрагиваемой позиции. Изменено в версии 2.5: Для *index* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **void `PyList_SET_ITEM`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *i*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*o*)** Макроформа [`PyList_SetItem()`](https://python-all.ru/2.6/c-api/list.html#PyList_SetItem) без проверки ошибок. Обычно используется только для заполнения новых списков, в которых нет предыдущего содержимого. > **Примечание** > > Этот макрос «крадёт» ссылку на *item* и, в отличие от [`PyList_SetItem()`](https://python-all.ru/2.6/c-api/list.html#PyList_SetItem), *не* освобождает ссылку на заменяемый элемент; любая ссылка в *list* на позиции *i* будет утеряна. Изменено в версии 2.5: Для *i* этот макрос использовал `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **int `PyList_Insert`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *index*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*item*)** Вставляет элемент *item* в список *list* перед индексом *index*. Возвращает `0` при успехе; возвращает `-1` и устанавливает исключение при неудаче. Аналогично `list.insert(index, item)`. Изменено в версии 2.5: Для *index* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **int `PyList_Append`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*item*)** Добавляет объект *item* в конец списка *list* . Возвращает `0` при успехе; возвращает `-1` и устанавливает исключение при неудаче. Аналогично `list.append(item)` . **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyList_GetSlice`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *low*, Py\_ssize\_t *high*)** *Возвращаемое значение: новая ссылка.* Возвращает список объектов из *list*, содержащий объекты *между* *low* и *high*. Возвращает *NULL* и устанавливает исключение при неудаче. Аналогично `list[low:high]`. Отрицательные индексы, как при срезе в Python, не поддерживаются. Изменено в версии 2.5: Для *low* и *high* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **int `PyList_SetSlice`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*, Py\_ssize\_t *low*, Py\_ssize\_t *high*, [PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*itemlist*)** Устанавливает срез *list* между *low* и *high* в содержимое *itemlist*. Аналогично `list[low:high] = itemlist`. *itemlist* может быть *NULL*, что означает присваивание пустого списка (удаление среза). Возвращает `0` при успехе, `-1` при неудаче. Отрицательные индексы, как при срезе в Python, не поддерживаются. Изменено в версии 2.5: Для *low* и *high* эта функция использовала `int`. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем. **int `PyList_Sort`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*)** Сортирует элементы *list* на месте. Возвращает `0` при успехе, `-1` при неудаче. Это эквивалентно `list.sort()` . **int `PyList_Reverse`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*)** Переворачивает элементы *списка* на месте. Возвращает `0` в случае успеха, `-1` при ошибке. Эквивалентно `list.reverse()` . **[PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject)\* `PyList_AsTuple`([PyObject](https://python-all.ru/2.6/c-api/structures.html#PyObject) *\*list*)** *Возвращаемое значение: новая ссылка.* Возвращает новый объект кортежа, содержащий элементы *списка*; эквивалентно `tuple(list)`.