历史版本。 PostgreSQL 8.1 已结束支持。 请参阅 当前版本手册.
SPI_modifytuple
SPI_modifytuple — 通过替换给定行中选定的字段来创建一个行
大纲
HeapTuple SPI_modifytuple(Relationrel, HeapTuplerow, intncols, int *colnum, Datum *values, const char *nulls)
描述
SPI_modifytuple 通过为选定列替换新值、并在其他位置复制原行的列来创建一行新记录。输入行本身不会被修改。新行会在上层执行器上下文中返回。
参数
Relationrel仅用作该行的行描述符来源。（传递关系而不是行描述符是个设计缺陷。）
HeapTuplerow要被修改的行
intncols数组
colnum中列号的数量int *colnum一个数组，包含要被修改的列的编号（列号从 1 开始）
Datum *values指定列的新值
const char *Nulls哪些新值为空值（如果有的话；格式参见
SPI_execute_plan）
返回值
修改后的新行，分配在上层执行器上下文中；仅当row
为 NULL 时才返回 NULL
出错时，SPI_result被设置如下：
SPI_ERROR_ARGUMENT如果
rel为NULL，或者row为NULL，或者ncols小于等于 0，或者colnum为NULL，或者values为NULL。SPI_ERROR_NOATTRIBUTE如果
colnum包含一个无效的列号（小于等于 0 或者大于row中的列数）。