历史版本。 PostgreSQL 7.0 已结束支持。 请参阅 当前版本手册.
大纲
SPI_modifytuple(rel,tuple,nattrs,attnum,Values,Nulls)
输入
- Relation
rel - HeapTuple
tuple 要修改的输入元组
- int
nattrs attnum 中属性编号的数量
- int *
attnum 要被修改的属性的编号组成的数组
- Datum *
Values 指定属性的新值
- char *
Nulls 哪些属性为 NULL（如果有的话）
输出
- HeapTuple
带修改内容的新元组
→ 非 NULLtuple不为 NULL 且修改成功时→ NULL仅当tuple为 NULL 时- SPI_result
→ SPI_ERROR_ARGUMENTrel 为 NULL，或 tuple 为 NULL，或 natts ≤ 0，或 attnum 为 NULL，或 Values 为 NULL 时。→ SPI_ERROR_NOATTRIBUTEattnum 中存在无效的属性编号时（attnum ≤ 0，或大于元组中的属性数量）
描述
SPI_modifytuple
在上层执行器上下文中修改元组。参见内存管理一节。
用法
成功时，返回指向新元组的指针。新元组在上层执行器上下文中分配（参见内存管理）。传入的元组不会被修改。