SPI_execp

Nom

SPI_execp -- exécute le plan préparé par SPI_prepare

Synopsis

int SPI_execp(void * plan, Datum *
valeurs, const char * nulls, int
nombre)

Description

SPI_execp exécute un plan préparé par SPI_prepare. nombre a la même interprétation que dans SPI_exec.

Arguments

void * plan

plan d'exécution (retourné par SPI_prepare)

Datum *values

valeurs actuelles des paramètres

const char * nulls

Un tableau décrivant les paramètres nuls. n indique une valeur nulle (l'entrée correspondante dans valeurs sera ignorée) ; un espace indique une valeur non nulle (l'entrée correspondante dans valeurs est valide).

Si nulls est NULL, alors SPI_execp part du principe qu'aucun paramètre n'est nul.

int nombre

nombre de lignes pour lesquelles le plan sera exécuté

Valeur de retour

La valeur de retour est la même que pour SPI_exec ou l'une des suivantes :

SPI_ERROR_ARGUMENT

si plan est NULL ou count est inférieur à 0

SPI_ERROR_PARAM

si values est NULL et plan est préparé avec des paramètres

SPI_processed et SPI_tuptable sont positionnées comme dans SPI_exec en cas de réussite.

Notes

Si l'un des objets (une table, une fonction, etc.) référencés par le plan préparé est effacé pendant la session, alors le résultat de SPI_execp pour ce plan sera imprévisible.