pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
pg_resultresultHandleresultOption
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 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。