# SPI_modifytuple ## Name SPI_modifytuple?--?通過替換一個給出行的選定的字段創建一行 ## Synopsis ``` HeapTuple SPI_modifytuple(Relation rel, HeapTuple row, int ncols, int * colnum, Datum * values, const char * nulls) ``` ## 描述 `SPI_modifytuple`通過給選定的字段替換新值， 拷貝其它字段的原值的方法創建一個新行。不修改輸入的行。 ## 參數 `Relation` `rel` 只用于該行的行描述符的源(傳遞一個關系而不是一個行描述符是一個誤特性)。 `HeapTuple` `row` 要修改的行 `int` `ncols` 要修改的字段數目 `int *` `colnum` 長度`ncols`的一個數組，包含要修改的字段的數目(字段編號從 1 開始記) `Datum *` `values` 長度`ncols`的一個數組，包含聲明字段的新值 `const char *` `nulls` 長度`ncols`的一個數組，描述哪個新值是空 如果`nulls`是`NULL`，那么`SPI_modifytuple` 假設沒有參數為空。否則，如果對應的參數值是非空的，那么`nulls` 數組的每一項都應該是`'?'`，或者如果對應的參數值為空，那么 `nulls`數組的每一項都是`'n'`。 （在后面這種情況下，對應的`values`項中的實際值無關緊要。） 請注意，`nulls`不是文本字符串，只是一個數組： 它不需要`'\0'`終止符。 ## 返回值 修改后的新行，在上層執行者環境里分配；只有在`row` 是`NULL`的時候為`NULL` 錯誤時，`SPI_result`的設置如下： `SPI_ERROR_ARGUMENT` 如果`rel`是`NULL`，或者如果`row`是`NULL`， 或者如果`ncols`小于或者等于 0 ，或者`colnum`是`NULL`， 或者如果`values`是`NULL`。 `SPI_ERROR_NOATTRIBUTE` 如果`colnum`包含一個無效的字段編號(小于或者等于 0 或者大于 `row`里的字段數)