↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

已结束支持的版本: 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本。 PostgreSQL 7.4 已结束支持。 请参阅 当前版本手册.

pg_result

pg_result — 获取关于命令结果的信息

大纲

pg_result resultHandle resultOption

描述

pg_result 返回关于先前 pg_exec 所创建命令结果的信息。

你可以根据需要把一个命令结果保留任意长的时间,但用完之后,务必通过执行 pg_result -clear 来释放它。否则就会发生内存泄漏,pgtcl 最终会开始抱怨你创建了太多命令结果对象。

参数

resultHandle

命令结果的句柄。

resultOption

下列选项之一,指定要返回哪部分结果信息:

-status

结果的状态。

-error

错误消息,如果状态表明是一个错误,否则为空字符串。

-conn

产生该结果的连接。

-oid

如果命令是一条 INSERT,则为被插入行的 OID,否则为 0。

-numTuples

查询返回的行(元组)数。

-cmdTuples

被该命令影响的行(元组)数。

-numAttrs

每行中的列(属性)数。

-assign arrayName

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

-assignbyidx arrayName ?appendstr?

使用第一列的值和其余列的名称作为键,把结果赋给一个数组。如果给定了 appendstr,则把它追加到每个键之后。简而言之,除了每行的第一列之外的所有列都会被存入数组,使用形如 (firstColumnValue, columnNameAppendStr) 的下标。

-getTuple rowNumber

以列表形式返回指定行的各列。行号从零开始。

-tupleArray rowNumber arrayName

把该行的各列存入数组 arrayName,以列名作为索引。行号从零开始。

-attributes

返回结果中各列名称的列表。

-lAttributes

返回一个子列表的列表,每列对应 {name typeOid typeSize}。

-clear

清除命令结果对象。

返回值

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

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.