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 的数组，描述哪些新值为 null
如果 nulls 为 NULL，则 SPI_modifytuple 假设没有新值为 null。否则，nulls 数组的每个条目如果对应的新值为非 null，则应为 ' '，如果对应的新值为 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 未处于活动状态
如果您在文档中看到任何不正确的内容，与您对特定功能的体验不符，或者需要进一步说明，请使用此表单报告文档问题。