Объекты списков¶List Objects
- PyTypeObject PyList_Type¶
- Этот экземпляр PyTypeObject представляет тип Python list. Это тот же объект, что и list на уровне Python.
- int PyList_Check(PyObject *p)¶
Возвращает истину, если p является объектом списка или экземпляром подтипа типа list.
Изменено в версии 2.2: Теперь допускаются подтипы.
- int PyList_CheckExact(PyObject *p)¶
Возвращает истину, если p является объектом списка, но не экземпляром подтипа типа list.
Новое в версии 2.2.
- PyObject* PyList_New(Py_ssize_t len)¶
- Возвращаемое значение: новая ссылка.
Возвращает новый список длины len в случае успеха или NULL при неудаче.
Примечание
Если length больше нуля, элементы возвращаемого списка устанавливаются в NULL. Поэтому нельзя использовать абстрактные функции API, такие как PySequence_SetItem(), или передавать этот объект в код Python, пока все элементы не будут установлены в реальные объекты с помощью PyList_SetItem().
Изменено в версии 2.5: Для size эта функция использовала int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- Py_ssize_t PyList_Size(PyObject *list)¶
Возвращает длину объекта списка list; это эквивалентно len(list) для объекта списка.
Изменено в версии 2.5: Эта функция возвращала int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- Py_ssize_t PyList_GET_SIZE(PyObject *list)¶
Макроформа PyList_Size() без проверки ошибок.
Изменено в версии 2.5: Этот макрос возвращал int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- PyObject* PyList_GetItem(PyObject *list, Py_ssize_t index)¶
- Возвращаемое значение: заимствованная ссылка.
Возвращает объект в позиции pos списка, на который указывает p. Позиция должна быть положительной; индексация с конца списка не поддерживается. Если pos выходит за границы, возвращает NULL и устанавливает исключение IndexError.
Изменено в версии 2.5: Для index эта функция использовала int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- PyObject* PyList_GET_ITEM(PyObject *list, Py_ssize_t i)¶
- Возвращаемое значение: заимствованная ссылка.
Макроформа PyList_GetItem() без проверки ошибок.
Изменено в версии 2.5: Для i этот макрос использовал int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- int PyList_SetItem(PyObject *list, Py_ssize_t index, PyObject *item)¶
Устанавливает элемент с индексом index в списке равным item. Возвращает 0 в случае успеха или -1 при неудаче.
Примечание
Эта функция «забирает» ссылку на item и отбрасывает ссылку на элемент, уже находящийся в списке на затрагиваемой позиции.
Изменено в версии 2.5: Для index эта функция использовала int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- void PyList_SET_ITEM(PyObject *list, Py_ssize_t i, PyObject *o)¶
Макроформа PyList_SetItem() без проверки ошибок. Обычно используется только для заполнения новых списков, в которых нет предыдущего содержимого.
Примечание
Этот макрос «крадёт» ссылку на item и, в отличие от PyList_SetItem(), не освобождает ссылку на заменяемый элемент; любая ссылка в list на позиции i будет утеряна.
Изменено в версии 2.5: Для i этот макрос использовал int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- int PyList_Insert(PyObject *list, Py_ssize_t index, PyObject *item)¶
Вставляет элемент item в список list перед индексом index. Возвращает 0 при успехе; возвращает -1 и устанавливает исключение при неудаче. Аналогично list.insert(index, item).
Изменено в версии 2.5: Для index эта функция использовала int. Это может потребовать изменений в вашем коде для корректной поддержки 64-разрядных систем.
- int PyList_Append(PyObject *list, PyObject *item)¶
- Добавляет объект item в конец списка list. Возвращает 0 при успехе; возвращает -1 и устанавливает исключение при неудаче. Аналогично list.append(item).
- PyObject* PyList_GetSlice(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 *list, Py_ssize_t low, Py_ssize_t high, 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 *list)¶
- Сортирует элементы list на месте. Возвращает 0 при успехе, -1 при неудаче. Это эквивалентно list.sort().