PostgreSQL 9.4.4 中文手册
上一页 | 上一级 |  | 下一页

# SPI_modifytuple

## 名称

SPI_modifytuple -- 通过替换一个给出行的选定的字段创建一行

## 大纲

    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`里的字段数)

上一页 | 起始页 | 下一页
SPI_returntuple | 上一级 | SPI_freetuple