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 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.

ARGUMENTS

       HeapTuple row
           row to be copied

RETURN VALUE

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

PostgreSQL 17.5                                       2025                                      SPI_COPYTUPLE(3)