pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
SPI_modifytuple(rel,tuple,nattrs,attnum,Values,Nulls)
rel仅用作元组的元组描述符来源。(传关系而不是元组描述符是一种 缺陷设计。)
tuple要修改的输入元组
nattrsattnum 数组中属性编号的数量
attnum要被修改的属性的编号组成的数组
Values指定属性的新值
Nulls哪些新值为 NULL(如果有的话)
带修改内容的新元组
→ 非 NULL tuple 不为 NULL 且修改成功时 |
→ NULL 仅当 tuple 为 NULL 时 |
→ SPI_ERROR_ARGUMENT rel 为 NULL,或 tuple 为 NULL,或 natts <= 0, 或 attnum 为 NULL,或 Values 为 NULL 时。 |
→ SPI_ERROR_NOATTRIBUTE attnum 中存在无效的 属性编号时(attnum <= 0,或大于元组中的 属性数量) |
SPI_modifytuple 为选定的属性替换新值,并在其他位置复制原元组的属性,从而创建一个 新元组。输入元组不会被修改。
成功时,返回指向新元组的指针。新元组在上层执行器上下文中分配。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。