HeapTuple SPI_modifytuple(Relation rel, HeapTuple row, int ncols, int * colnum, Datum * values, const char * nulls)
只被用作该行的行描述符的来源(传递一个关系而不是 一个行描述符是一种令人头痛的设计)。
要被修改的行
要被修改的列数
一个长度为ncols的数组,包含了要被修改的列号 (列号从 1 开始)
一个长度为ncols的数组,包含了指定列的新值
一个长度为ncols的数组,描述哪些新值为空值
如果nulls为NULL,那么
SPI_modifytuple
假定没有新值为空值。否则,
如果对应的新值为非空,nulls数组的每一项都应
该是' ',而如果对应的新值为空值则为'n'(在
后一种情况中,对应的values项中的新值无关紧
要)。注意nulls不是一个文本字符串,只是一个
数组:它不需要一个'\0'终止符。
应用了修改的新行,在上层执行器上下文中分配,只有当 row为NULL时才返回 NULL
出错时,SPI_result被设置如下:
如果rel为NULL,或者 row为NULL,或者ncols 小于等于 0,或者colnum为NULL, 或者values为NULL。
如果colnum包含一个无效的列号(小于等于 0 或者大于 row中的列数)。