历史版本。 PostgreSQL 6.4 已结束支持。 请参阅 当前版本手册.
大纲
pg_resultresultHandleresultOption
输入
-
resultHandle 一个查询结果的句柄。
-
resultOption 指定若干可能选项之一。
选项
- -status
结果的状态。
- -error
错误消息(如果状态表示出错);否则为空字符串。
- -conn
产生该结果的连接。
- -oid
如果命令是 INSERT,为所插入元组的 OID;否则为空字符串。
- -numTuples
查询返回的元组数。
- -numAttrs
每个元组中的属性数。
- -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 最终会抱怨你创建了太多查询结果对象。