SPI_modifytuple

Nom

SPI_modifytuple -- cr�e une ligne en rempla�ant les champs s�lectionn�s d'une ligne donn�e

Synopsis

HeapTuple SPI_modifytuple(Relation rel, HeapTuple row, ncols, colnumber, Datum * values, const char * nulls)

Description

SPI_modifytuple cr�e une nouvelle ligne en retirant les nouvelles valeurs pour les colonnes s�lectionn�es et en copiant les colonnes de la ligne d'origine � d'autres positions. La ligne d'entr�e n'est pas modifi�e.

Arguments

Relation rel

Utilis� seulement en tant que source du descripteur de ligne pour la ligne (passez une relation plut�t qu'un descripteur de ligne est une erreur).

HeapTuple row

rang�e � modifier

int ncols

nombre de num�ros de colonnes dans le tableau colnumber

int * colnumber

tableau des num�ros de colonnes � modifier (le num�ro des colonnes commence � 1)

Datum * values

nouvelles valeurs pour les colonnes sp�cifi�es

const char * nulls

quelles nouvelles valeurs sont NULL, si elles existent (voir SPI_executeplan pour le format)

Valeur de retour

nouvelle ligne avec modifications, allou�e dans le contexte de m�moire courant ; NULL seulement si row est NULL

En cas d'erreur, SPI_result est positionn�e comme suit :

SPI_ERROR_ARGUMENT

si rel est NULL ou si row est NULL ou si ncols est inf�rieur ou �gal � 0 ou si nocolonne est NULL ou si valeurs est NULL.

SPI_ERROR_NOATTRIBUTE

si nocolonne contient un num�ro de colonne invalide (inf�rieur ou �gal � 0 ou sup�rieur au num�ro de colonne dans row)