Question

函数名

SPI_modifytuple--通过替换一个给出行的选定的字段创建一行

原型

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

描述

SPI_modifytuple 通过给选定的字段替换新值，拷贝其它字段的原值的方法创建一个新行。不修改输入的行。

参数

Relation rel

只用于该行的行描述符的源(传递一个关系而不是一个行描述符是一个误特性)。

HeapTuple row

要修改的行

int ncols

在数组 colnum 里字段编号的个数

int * colnum

要修改的字段的编号的数组(编号从 1 开始记)

Datum * values

声明字段的新值

const char * Nulls

如果有的话，哪个新值是空(参阅 SPI_execute_plan 获取其格式)

返回值

修改后的新行，在上层执行者环境里分配；只有在 row 是 NULL 的时候为 NULL

On error, SPI_result is set as follows:

SPI_ERROR_ARGUMENT

如果 rel 是 NULL ，或者如果 row 是 NULL ，或者如果 ncols 小于或者等于 0 ，或者 colnum 是 NULL ，或者如果 values 是 NULL

SPI_ERROR_NOATTRIBUTE

如果 colnum 包含一个无效的字段编号(小于或者等于 0 或者大于 row 里的字段数)