SPI_modifytuple — 通过替换一个给定行的选定域来创建一行
HeapTuple SPI_modifytuple(Relationrel
, HeapTuplerow
, intncols
, int *colnum
, Datum *values
, const char *nulls
)
SPI_modifytuple
创建一个新行,其中选定的列
用新值替代,其他列则从输入行中拷贝。输入行本身不被修改。
新行在上层执行器上下文中返回。
该函数只能在连接到SPI时使用。否则,它会返回NULL并将SPI_result
设置为SPI_ERROR_UNCONNECTED
。
Relation rel
只被用作该行的行描述符的来源(传递一个关系而不是 一个行描述符是一种令人头痛的设计)。
HeapTuple row
要被修改的行
int ncols
要被修改的列数
int * colnum
一个长度为ncols
的数组,包含了要被修改的列号
(列号从 1 开始)
Datum * values
一个长度为ncols
的数组,包含了指定列的新值
const char * nulls
一个长度为ncols
的数组,描述哪些新值为空值
如果nulls
为NULL
,那么
SPI_modifytuple
假定没有新值为空值。否则,
如果对应的新值为非空,nulls
数组的每一项都应
该是' '
,而如果对应的新值为空值则为'n'
(在
后一种情况中,对应的values
项中的新值无关紧
要)。注意nulls
不是一个文本字符串,只是一个
数组:它不需要一个'\0'
终止符。
应用了修改的新行,在上层执行器上下文中分配,或者错误时为
NULL
(参阅SPI_result
获取错误指示)
出错时,SPI_result
被设置如下:
SPI_ERROR_ARGUMENT
如果rel
为NULL
,或者
row
为NULL
,或者ncols
小于等于 0,或者colnum
为NULL
,
或者values
为NULL
。
SPI_ERROR_NOATTRIBUTE
如果colnum
包含一个无效的列号(小于等于 0 或者大于
row
中的列数)。
SPI_ERROR_UNCONNECTED
如果SPI未激活