↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

不受支持的版本: 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 7.2 已于 2007 年 2 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页。

SPI_modifytuple

SPI_modifytuple — 通过替换给定元组中的选定字段来创建一个元组

大纲

SPI_modifytuple(rel, tuple, nattrs, attnum, Values, Nulls)

输入

Relation rel

仅用作元组的元组描述符来源。(传关系而不是元组描述符是一种 缺陷设计。)

HeapTuple tuple

要修改的输入元组

int nattrs

attnum 数组中属性编号的数量

int * attnum

要被修改的属性的编号组成的数组

Datum * Values

指定属性的新值

char * Nulls

哪些新值为 NULL(如果有的话)

输出

HeapTuple

带修改内容的新元组

→ 非 NULL tuple 不为 NULL 且修改成功时
→ NULL 仅当 tuple 为 NULL 时
SPI_result
→ SPI_ERROR_ARGUMENT rel 为 NULL,或 tuple 为 NULL,或 natts <= 0, 或 attnum 为 NULL,或 Values 为 NULL 时。
→ SPI_ERROR_NOATTRIBUTE attnum 中存在无效的 属性编号时(attnum <= 0,或大于元组中的 属性数量)

描述

SPI_modifytuple 为选定的属性替换新值,并在其他位置复制原元组的属性,从而创建一个 新元组。输入元组不会被修改。

用法

成功时,返回指向新元组的指针。新元组在上层执行器上下文中分配。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。