PostgreSQL
Description
SPI_returntuple
makes a copy of a row in the upper executor context, returning it in the form of a row type Datum
. The returned pointer need only be converted to Datum
via PointerGetDatum
before returning.
This function can only be used while connected to SPI. Otherwise, it returns NULL and sets SPI_result
to SPI_ERROR_UNCONNECTED
.
Note that this should be used for functions that are declared to return composite types. It is not used for triggers; use SPI_copytuple
for returning a modified row in a trigger.
Arguments
- `HeapTuple +`_`+row`_
-
row to be copied
- `TupleDesc +`_`+rowdesc`_
-
descriptor for row (pass the same descriptor each time for most effective caching)
Submit correction
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.
Copyright © 1996-2024 The PostgreSQL Global Development Group