| Documentation PostgreSQL 8.0.2 | ||||
|---|---|---|---|---|
| Précédent | Arrière rapide | Avance rapide | Suivant | |
HeapTuple SPI_modifytuple(Relation rel, HeapTuple ligne, ncols, nocolonne, Datum * valeurs, const char * nulls)
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.
Utilisé seulement en tant que source du descripteur de ligne pour la ligne. (Passer une relation plutôt qu'un descripteur de ligne est une erreur.)
rangée à modifier
nombre de numéros de colonnes dans le tableau nocolonne
tableau des numéros des colonnes à modifier (le numéro des colonnes commence à 1)
nouvelles valeurs pour les colonnes spécifiées
quelles nouvelles valeurs sont null, si elles existent (voir
SPI_executeplan pour le format)
nouvelle ligne avec modifications, allouée dans le contexte de mémoire courant ; NULL seulement si ligne est NULL
En cas d'erreur, SPI_result est positionné comme suit :
si rel est NULL ou si ligne est NULL ou si ncols est inférieur ou égal à 0 ou si nocolonne est NULL ou si valeurs est NULL.
si nocolonne contient un numéro de colonne invalide (inférieur ou égal à 0 ou supérieur au numéro de colonne dans ligne)
| Précédent | Sommaire | Suivant |
| SPI_returntuple | Niveau supérieur | SPI_freetuple |