SPI_returntuple

SPI_returntuple — se prepara para devolver una tupla como un Datum

Synopsis

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

Descripción

SPI_returntuple hace una copia de una fila en el contexto superior del ejecutor, devolviéndola en forma de un tipo de fila Datum. El puntero devuelto solo necesita convertirse a Datum mediante PointerGetDatum antes de retornar.

Esta función solo se puede usar mientras se está conectado a SPI. De lo contrario, devuelve NULL y establece SPI_result en SPI_ERROR_UNCONNECTED.

Tenga en cuenta que esto debe usarse para funciones declaradas para devolver tipos compuestos. No se utiliza para disparadores (triggers); use SPI_copytuple para devolver una fila modificada en un disparador.

Argumentos

HeapTuple row

fila a copiar

TupleDesc rowdesc

descriptor de la fila (pase el mismo descriptor cada vez para un almacenamiento en caché más eficaz)

Valor de retorno

HeapTupleHeader que apunta a la fila copiada, o NULL en caso de error (consulte SPI_result para una indicación de error)