Rb Cafe » Postgres » Documentation PostgreSQL 13.10 » Programmation serveur » Interface de programmation serveur » Fonctions d'interface » SPI_execp

SPI_execp

SPI_execp — exécute une requête en mode lecture/écriture

Synopsis

int SPI_execp(SPIPlanPtr plan, Datum * values, const char * nulls, long count)

Description

SPI_execp est identique à SPI_execute_plan mais le paramètre read_only de ce dernier vaut toujours false.

Arguments

SPIPlanPtr plan

requête préparée (renvoyée par SPI_prepare)

Datum * values

Un tableau des vraies valeurs de paramètre. Doit avoir la même longueur que le nombre d'arguments de la requête.

const char * nulls

Un tableau décrivant les paramètres NULL. Doit avoir la même longueur que le nombre d'arguments de la requête.

Si nulls vaut NULL, alors SPI_executep suppose qu'aucun paramètre n'est NULL. Dans le cas contraire, chaque entrée du tableau nulls doit valoir ' ' si le paramètre correspondant est non NULL et 'n' si le paramètre correspondant est NULL (dans ce dernier cas, la valeur réelle de l'entrée values correspondante n'a pas d'importance). Notez que nulls n'est pas une chaîne de texte. C'est un tableau et, de ce fait, il n'a pas besoin d'un caractère de fin '\0'.

long count

nombre maximum de lignes à renvoyer ou 0 pour aucune ligne à renvoyer

Valeur de retour

Voir SPI_execute_plan.

SPI_processed et SPI_tuptable sont initialisées comme dans SPI_execute en cas de succès.