Объекты кортежей¶Tuple Objects

type PyTupleObject¶

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

PyTypeObject PyTuple_Type¶

Часть Stable ABI.

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

int PyTuple_Check(PyObject *p)¶

Возвращает истину, если p является объектом кортежа или экземпляром подтипа типа кортежа. Эта функция всегда завершается успешно.

int PyTuple_CheckExact(PyObject *p)¶

Возвращает истину, если p является объектом кортежа, но не экземпляром подтипа типа кортежа. Эта функция всегда завершается успешно.

PyObject *PyTuple_New(Py_ssize_t len)¶

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

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

PyObject *PyTuple_Pack(Py_ssize_t n, ...)¶

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

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

Py_ssize_t PyTuple_Size(PyObject *p)¶

Часть Stable ABI.

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

Py_ssize_t PyTuple_GET_SIZE(PyObject *p)¶

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

PyObject *PyTuple_GetItem(PyObject *p, Py_ssize_t pos)¶

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

Возвращает объект на позиции 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)¶

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

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

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

Часть Stable ABI.

Вставляет ссылку на объект 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.

Объекты структурных кортежей¶Struct Sequence Objects

Объекты структурных последовательностей – это C-аналог объектов namedtuple(), т.е. последовательности, элементы которой также доступны через атрибуты. Чтобы создать структурную последовательность, сначала нужно создать конкретный тип структурной последовательности.

PyTypeObject *PyStructSequence_NewType(PyStructSequence_Desc *desc)¶

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

Создаёт новый тип структурного кортежа из данных в desc, описанных ниже. Экземпляры полученного типа могут быть созданы с помощью PyStructSequence_New().

void PyStructSequence_InitType(PyTypeObject *type, PyStructSequence_Desc *desc)¶

Инициализирует тип структурного кортежа type из desc на месте.

int PyStructSequence_InitType2(PyTypeObject *type, PyStructSequence_Desc *desc)¶

То же, что и PyStructSequence_InitType, но возвращает 0 в случае успеха и -1 в случае ошибки.

Новое в версии 3.4.

type PyStructSequence_Desc¶

Часть Stable ABI (включая все члены).

Содержит метаинформацию о типе структурного кортежа, который необходимо создать.

const char *name¶

Имя типа структурированной последовательности.

const char *doc¶

Указатель на строку документации типа или NULL, чтобы опустить.

PyStructSequence_Field *fields¶

Указатель на массив, завершающийся NULL, с именами полей нового типа.

int n_in_sequence¶

Количество полей, видимых на стороне Python (если используется как кортеж).

type PyStructSequence_Field¶

Часть Stable ABI (включая все члены).

Описывает поле структурного кортежа. Поскольку структурный кортеж моделируется как кортеж, все поля имеют тип PyObject*. Индекс в массиве fields структуры PyStructSequence_Desc определяет, какое поле структурного кортежа описывается.

const char *name¶

Имя поля или NULL, чтобы завершить список именованных полей, установите в PyStructSequence_UnnamedField, чтобы оставить безымянным.

const char *doc¶

Докстринг поля или NULL, чтобы опустить.

const char *const PyStructSequence_UnnamedField¶

Часть Stable ABI начиная с версии 3.11.

Специальное значение для имени поля, чтобы оставить его безымянным.

Изменено в версии 3.9: Тип был изменён с char *.

PyObject *PyStructSequence_New(PyTypeObject *type)¶

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

Создаёт экземпляр type, который должен быть создан с помощью PyStructSequence_NewType().

PyObject *PyStructSequence_GetItem(PyObject *p, Py_ssize_t pos)¶

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

Возвращает объект на позиции pos в структурированной последовательности, на которую указывает p. Проверка границ не выполняется.

PyObject *PyStructSequence_GET_ITEM(PyObject *p, Py_ssize_t pos)¶

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

Макрос, эквивалентный PyStructSequence_GetItem().

void PyStructSequence_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o)¶

Часть Stable ABI.

Устанавливает поле по индексу pos в struct sequence p в значение o. Как и PyTuple_SET_ITEM(), это следует использовать только для заполнения совсем новых экземпляров.

Примечание

Эта функция «крадёт» ссылку на o.

void PyStructSequence_SET_ITEM(PyObject *p, Py_ssize_t *pos, PyObject *o)¶

Аналогичен PyStructSequence_SetItem(), но реализован как статическая встраиваемая функция.

Примечание

Эта функция «крадёт» ссылку на o.