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

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

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

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

清除命令结果对象。

返回值

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

提交更正

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