pg_result

Name

pg_result — 获取查询结果的信息
pg_result resultHandle resultOption

输入

resultHandle

查询结果的句柄.

resultOption

声明几个可能选项之一.

选项

-status

结果的状态.

-error

如果状态标识为错误时这里是错误信息;否则是一个空字符串.

-conn

生成结果的联接.

-oid

如果命令是一个 INSERT,这里是插入的记录的 OID;否则是一个空字符串.

-numTuples

查询返回的记录个数.

-numAttrs

每条记录的字段数目.

-list VarName

把结果赋与一个列表.

-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 最终将开始抱怨你创建了太多的查询结果对象.