SPI_modifytuple

Name

SPI_modifytuple — 元组被修改的关系
SPI_modifytuple(rel, tuple , nattrs
, attnum , Values , Nulls)

输入

Relation rel

HeapTuple tuple

要修改的输入元组

int nattrs

attnum 里字段号的个数

int * attnum

将要修改的字段号的数组

Datum * Values

给声明的属性的新值

char * Nulls

若存在,哪个字段是 NULL.

输出

HeapTuple

修改后的新元组

non-NULL: 如果 tuple 为非空(not NULL)并且修改成功
NULL: 只有当 tuple 为 NULL(空)

SPI_result

SPI_ERROR_ARGUMENT: 如果 rel 是 NULL 或 tuple 是 NULL 或 natts ≤ 0 或 attnum 是 NULL 或 Values 是 NULL.
SPI_ERROR_NOATTRIBUTE: 如果在 attnum 里有一个非法的数字 (attnum ≤ 0 或 > 记录中字段数)

描述

SPI_modifytuple 修改一个上层执行器环境的记录.参考存储器管理章节.

用法

如果成功,返回一个指向新记录的指针. 新记录在执行器上层环境分配(参见 存储器管理).传入的记录没有改变.