Name
SPI_modifytuple -- 通过替换一个给出元组的选定字段创建一个元组
Synopsis
SPI_modifytuple(
rel
,
tuple
,
nattrs
,
attnum
,
Values
,
Nulls
)
输入
-
Relation
rel
-
只用做元组的元组描述符的源．
(传递关系而不是一个元组描述符是错误的特性．)
-
HeapTuple
tuple
-
要修改的输入元组
-
int
nattrs
-
在 attnum 数组里的字段数
-
int *
attnum
-
要修改的字段的编码数组
-
Datum *
Values
-
为那些字段声明的新数值
New values for the attributes specified
-
char *
Nulls
-
如果有地话，哪些新数值是 NULL
输出
-
HeapTuple
-
经过修改的新元组
|
如果
tuple
非 NULL 并且修改成功则为
非 NULL
|
|
只有
tuple
为 NULL 的时候为
NULL
|
-
SPI_result
-
|
如果 rel 是 NULL 或者元组为 NULL 或者 natts <= 0
或者 attnum 为 NULL 或者 Values 为 NULL 则返回
SPI_ERROR_ARGUMENT
|
|
如果在 attnum 里有非法的字段号(attnum <= 0 或 > 元组中的属性
数目)则返回
SPI_ERROR_NOATTRIBUTE
． |
描述
SPI_modifytuple
通过把新数值替换到选定的字段中，然后把元组其它
字段拷贝到相应位置创建一个新的元组．不会修改输入元组．
用法
如果成功，返回一个指向新元组的指针．
新元组是在上层执行器环境中分配的．
|