大纲
pg_resultresultHandleresultOption
描述
pg_result 返回关于先前
pg_exec 所创建命令结果的信息。
你可以根据需要把一个命令结果保留任意长的时间,但用完之后,务必通过执行
pg_result -clear 来释放它。否则就会发生内存泄漏,pgtcl 最终会开始抱怨你创建了太多命令结果对象。
参数
resultHandle命令结果的句柄。
resultOption下列选项之一,指定要返回哪部分结果信息:
-status结果的状态。
-error错误消息,如果状态表明是一个错误,否则为空字符串。
-conn产生该结果的连接。
-oid如果命令是一条
INSERT,则为被插入行的 OID,否则为 0。-numTuples查询返回的行(元组)数。
-cmdTuples被该命令影响的行(元组)数。
-numAttrs每行中的列(属性)数。
-assignarrayName把结果赋给一个数组,使用形如
(rowNumber, columnName)的下标。-assignbyidxarrayName?appendstr?使用第一列的值和其余列的名称作为键,把结果赋给一个数组。如果给定了
appendstr,则把它追加到每个键之后。简而言之,除了每行的第一列之外的所有列都会被存入数组,使用形如(firstColumnValue, columnNameAppendStr)的下标。-getTuplerowNumber以列表形式返回指定行的各列。行号从零开始。
-tupleArrayrowNumberarrayName把该行的各列存入数组
arrayName,以列名作为索引。行号从零开始。-attributes返回结果中各列名称的列表。
-lAttributes返回一个子列表的列表,每列对应
{name typeOid typeSize}。-clear清除命令结果对象。
返回值
结果取决于所选的选项,如上所述。