SPI_returntuple

SPI_returntuple — prepara para retornar uma tupla como um Datum

Sinopse

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

Descrição

A função SPI_returntuple faz a cópia de uma linha no contexto do executor superior, retornando-a na forma de uma linha do tipo de dados Datum. O ponteiro retornado só precisa ser convertido no tipo de dados Datum via PointerGetDatum antes de retornar.

Esta função só pode ser usada enquanto conectado à SPI. Caso contrário, irá retornar NULL e definir SPI_result como SPI_ERROR_UNCONNECTED.

Note que esta função deve ser usada para funções declaradas para retornar tipos de dados compostos. Não é usada para gatilhos; deve ser usada a função SPI_copytuple para retornar uma linha modificada em um gatilho.

Argumentos

HeapTuple row

linha a ser copiada

TupleDesc rowdesc

descritor para a linha (deve ser passado o mesmo descritor todas as vezes para obter um armazenamento em cache mais eficaz)

Valor retornado

HeapTupleHeader apontando para a linha copiada, ou NULL em caso de erro (veja SPI_result para obter uma indicação de erro)