SPI_copytuple — make a copy of a row in the upper executor context
HeapTuple SPI_copytuple(HeapTuple row
)
SPI_copytuple
makes a copy of a row in the upper executor context. This is normally used to return a modified row from a trigger. In a function declared to return a composite type, use SPI_returntuple
instead.
This function can only be used while connected to SPI. Otherwise, it returns NULL and sets SPI_result
to SPI_ERROR_UNCONNECTED
.
HeapTuple row
row to be copied
the copied row, or NULL
on error (see SPI_result
for an error indication)
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.