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

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

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

pg_result

pg_result — 获取关于查询结果的信息

大纲

pg_result resultHandle resultOption

输入

resultHandle

一个查询结果的句柄。

resultOption

指定若干可能选项之一。

选项

-status

结果的状态。

-error

错误消息(如果状态表示出错);否则为空字符串。

-conn

产生该结果的连接。

-oid

如果命令是 INSERT,为所插入元组的 OID;否则为 0。

-numTuples

查询返回的元组数。

-numAttrs

每个元组中的属性数。

-assign arrayName

把结果赋给一个数组,使用形如 (tupno,attributeName) 的下标。

-assignbyidx arrayName ?appendstr?

把结果赋给一个数组,用第一个属性的值和其余属性的名作为键。如果 给出了 appendstr,则把它追加到每个键之后。简而言之, 每个元组中除第一个字段外的所有字段都存入数组,使用形如 (firstFieldValue,fieldNameAppendStr) 的下标。

-getTuple tupleNumber

以列表形式返回所指元组的各字段。元组编号从零开始。

-tupleArray tupleNumber arrayName

把该元组的各字段存入数组 arrayName,以字段名 为索引。元组编号从零开始。

-attributes

返回元组各属性名的列表。

-lAttributes

返回子列表的列表,每个元组属性对应一个 {name ftype fsize}。

-clear

清除该查询结果对象。

输出

结果取决于所选的选项,如上所述。

描述

pg_result 返回关于由先前的 pg_exec 创建的查询结果的信息。

查询结果可以保留任意长的时间,但用完之后,务必通过执行 pg_result -clear 将其释放。否则会造成内存 泄漏,Pgtcl 最终会抱怨你创建了太多查询结果对象。

提交更正

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