home | help
SPI_COPYTUPLE(3)	  PostgreSQL 18.6 Documentation 	SPI_COPYTUPLE(3)

NAME
     SPI_copytuple - make a copy of a row in the upper executor context

SYNOPSIS
     HeapTuple SPI_copytuple(HeapTuple row)

DESCRIPTION
     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  de-
     clared to return a composite type, use SPI_returntuple instead.

     This  function  can  only be used while connected to SPI. Otherwise, it re-
     turns NULL and sets SPI_result to SPI_ERROR_UNCONNECTED.

ARGUMENTS
     HeapTuple row
	 row to be copied

RETURN VALUE
     the copied row, or NULL on error (see SPI_result for an error indication)

PostgreSQL 18.6 		      2026			SPI_COPYTUPLE(3)

home | help