pg_result

Name

pg_result --  获取查询结果的信息

Synopsis

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

清理查询对象结果.

返回值

由选定的选项决定的结果,如上所述.