SPI_modifytuple — 通过替换给定行中选定字段来创建行
HeapTuple SPI_modifytuple(Relationrel, HeapTuplerow, intncols, int *colnum, Datum *values, const char *nulls)
SPI_modifytuple 通过用新值替换选定列来创建新行，复制其他位置的原始行列。输入行不会被修改。新行在较高执行器上下文中返回。
此函数只能在连接到 SPI 时使用。否则，它将返回 NULL，并将 SPI_result 设置为 SPI_ERROR_UNCONNECTED。
关系 rel仅用作行的行描述符的源。（传递关系而不是行描述符是一个错误功能。）
堆元组 row要修改的行
int ncols要更改的列数
int * colnum长度为 ncols 的数组，包含要更改的列的编号（列编号从 1 开始）
Datum * values长度为 ncols 的数组，包含指定列的新值
const char * nulls长度为 ncols 的数组，描述哪些新值为空
如果 nulls 为 NULL，则 SPI_modifytuple 假设没有新值为空。否则，如果相应的新值不为空，则 nulls 数组的每个条目应为 ' '；如果相应的新值为 null，则应为 '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 未激活
如果您在文档中看到任何不正确的内容，与您对特定功能的体验不符或需要进一步澄清，请使用此表单报告文档问题。