SPI_returntuple

SPI_returntuple
Назад	Наверх	45.3. Управление памятью	Начало	Далее

---

SPI_returntuple

SPI_returntuple — подготовка к возврату кортежа в качестве значения типа Datum

Синтаксис

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

Описание

SPI_returntuple создает копию строки в контексте верхнего исполнителя и возвращает ее в виде типа строки Datum. Возвращаемый указатель нужно только преобразовать в Datum с помощью PointerGetDatum перед возвратом.

Эта функция может быть использована только при подключении к SPI. В противном случае она возвращает NULL и устанавливает SPI_result в SPI_ERROR_UNCONNECTED.

Обратите внимание, что это должно использоваться для функций, которые объявлены для возврата составных типов. Оно не используется для триггеров; используйте SPI_copytuple для возврата измененной строки в триггере.

Аргументы

HeapTuple row

строка для копирования

TupleDesc rowdesc

дескриптор для строки (передавайте один и тот же дескриптор каждый раз для наиболее эффективного кэширования)

Возвращаемое значение

HeapTupleHeader указывает на скопированную строку, или NULL в случае ошибки (см. SPI_result для указания ошибки)

---

Назад	Наверх	Далее
SPI_copytuple	Начало	SPI_modifytuple