Объекты кортежей

PyTupleObject

Этот подтип PyObject представляет объект кортежа Python.

PyTypeObject PyTuple_Type

Этот экземпляр PyTypeObject представляет тип кортежа Python; он является тем же объектом, что и tuple на уровне Python.

int PyTuple_Check(PyObject *p)

Возвращает true, если p — объект кортежа или экземпляр подтипа типа кортежа.

int PyTuple_CheckExact(PyObject *p)

Возвращает true, если p — объект кортежа, но не экземпляр подтипа типа кортежа.

PyObject* PyTuple_New(Py_ssize_t len)

Возвращаемое значение: Новая ссылка.

Возвращает новый объект кортежа размером len или NULL при ошибке.

PyObject* PyTuple_Pack(Py_ssize_t n, ...)

Возвращаемое значение: Новая ссылка.

Возвращает новый объект кортежа размером n или NULL при ошибке. Значения кортежа инициализируются последующими n аргументами C, указывающими на объекты Python. PyTuple_Pack(2, a, b) эквивалентно Py_BuildValue("(OO)", a, b).

Py_ssize_t PyTuple_Size(PyObject *p)

Принимает указатель на объект кортежа и возвращает размер этого кортежа.

Py_ssize_t PyTuple_GET_SIZE(PyObject *p)

Возвращает размер кортежа p, который должен быть не-NULL и указывать на кортеж; проверка ошибок не выполняется.

PyObject* PyTuple_GetItem(PyObject *p, Py_ssize_t pos)

Возвращаемое значение: Заимствованная ссылка.

Возвращает объект в позиции pos в кортеже, на который указывает p. Если pos выходит за пределы границ, возвращает NULL и устанавливает исключение IndexError.

PyObject* PyTuple_GET_ITEM(PyObject *p, Py_ssize_t pos)

Возвращаемое значение: Заимствованная ссылка.

Аналогично PyTuple_GetItem(), но не выполняет проверок своих аргументов.

PyObject* PyTuple_GetSlice(PyObject *p, Py_ssize_t low, Py_ssize_t high)

Возвращаемое значение: Новая ссылка.

Возвращает срез кортежа, на который указывает p, между low и high, или NULL при ошибке. Это эквивалентно выражению Python p[low:high]. Индексирование с конца списка не поддерживается.

int PyTuple_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o)

Вставляет ссылку на объект o в позицию pos кортежа, на который указывает p. Возвращает 0 при успехе. Если pos выходит за пределы границ, возвращает -1 и устанавливает исключение IndexError.

Примечание

Эта функция «заимствует» ссылку на o и отбрасывает ссылку на элемент, уже находящийся в кортеже в затронутой позиции.

void PyTuple_SET_ITEM(PyObject *p, Py_ssize_t pos, PyObject *o)

Аналогично PyTuple_SetItem(), но не выполняет проверки ошибок и должна только использоваться для заполнения совершенно новых кортежей.

Примечание

Этот макрос «заимствует» ссылку на o и, в отличие от PyTuple_SetItem(), не отбрасывает ссылку на любой элемент, который заменяется; любая ссылка в кортеже в позиции pos будет утечка.

int _PyTuple_Resize(PyObject **p, Py_ssize_t newsize)

Может использоваться для изменения размера кортежа. newsize будет новой длиной кортежа. Поскольку кортежи, как правило, неизменяемы, это следует использовать только в том случае, если на объект есть только одна ссылка. Не используйте это, если кортеж уже известен какой-либо другой части кода. Кортеж всегда будет расти или уменьшаться в конце. Представьте это как уничтожение старого кортежа и создание нового, только более эффективно. Возвращает 0 при успехе. Код клиента никогда не должен предполагать, что результирующее значение *p будет таким же, как до вызова этой функции. Если объект, на который ссылается *p, заменён, оригинальный *p уничтожается. При ошибке возвращает -1 и устанавливает *p в NULL, и вызывает MemoryError или SystemError.

int PyTuple_ClearFreeList()

Очистить свободный список. Возвращает общее количество освобождённых элементов.