SPI_FREETUPTABLE(3) PostgreSQL 18.6 Documentation SPI_FREETUPTABLE(3) NAME SPI_freetuptable - free a row set created by SPI_execute or a similar func- tion SYNOPSIS void SPI_freetuptable(SPITupleTable * tuptable) DESCRIPTION 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 an SPI-using C function needs to execute multi- ple 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 an SPI-using C function, SPI automatically frees any row sets created while the subtransaction was running. Beginning in PostgreSQL 9.3, SPI_freetuptable contains guard logic to pro- tect against duplicate deletion requests for the same row set. In previous releases, duplicate deletions would lead to crashes. ARGUMENTS SPITupleTable * tuptable pointer to row set to free, or NULL to do nothing PostgreSQL 18.6 2026 SPI_FREETUPTABLE(3)
NAME | SYNOPSIS | DESCRIPTION | ARGUMENTS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=SPI_freetuptable&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>