Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
SPI_FREETUPTABLE(3)	PostgreSQL 9.6.24 Documentation	   SPI_FREETUPTABLE(3)

       SPI_freetuptable	- free a row set created by SPI_execute	or a similar

       void SPI_freetuptable(SPITupleTable * tuptable)

       SPI_freetuptable	frees a	row set	created	by a prior SPI command
       execution function, such	as SPI_execute.	Therefore, this	function is
       often called with the global variable SPI_tuptable as argument.

       This function is	useful if a SPI	procedure needs	to execute multiple
       commands	and does not want to keep the results of earlier commands
       around until it ends. Note that any unfreed row sets will be freed
       anyway at SPI_finish. Also, if a	subtransaction is started and then
       aborted within execution	of a SPI procedure, SPI	automatically frees
       any row sets created while the subtransaction was running.

       Beginning in PostgreSQL 9.3, SPI_freetuptable contains guard logic to
       protect against duplicate deletion requests for the same	row set. In
       previous	releases, duplicate deletions would lead to crashes.

       SPITupleTable * tuptable
	   pointer to row set to free, or NULL to do nothing

PostgreSQL 9.6.24		     2021		   SPI_FREETUPTABLE(3)


Want to link to this manual page? Use this URL:

home | help