Documentation PostgreSQL 14.22 » Programmation serveur » Interface de programmation serveur » Gestion de la mémoire » SPI_copytuple

Précédent | Niveau supérieur | Suivant
SPI_pfree | Sommaire | SPI_returntuple

## SPI_copytuple

SPI_copytuple — effectue une copie d'une ligne dans le contexte de mémoire courant

## Synopsis

    HeapTuple SPI_copytuple(HeapTuple row)

## Description

`SPI_copytuple` crée une copie d'une ligne dans le contexte de mémoire courant. Ceci est normalement utilisé pour renvoyer une ligne modifiée à partir d'un déclencheur. Dans une fonction déclarée pour renvoyer un type composite, utilisez `SPI_returntuple` à la place.

Cette fonction peut seulement être utilisée durant une connexion SPI. Sinon, elle renvoie NULL et affecte `SPI_ERROR_UNCONNECTED` à `SPI_result`.

## Arguments

`HeapTuple `row``

  ligne à copier

## Valeur de retour

la ligne copiée ou `NULL` en cas d'erreur (voir `SPI_result` pour une indication sur l'erreur)