This page in other versions: Unsupported versions: 7.1 / 7.2 / 7.3 / 7.4



pg_result -- get information about a command result


pg_result resultHandle resultOption


pg_result returns information about a command result created by a prior pg_exec.

You can keep a command result around for as long as you need it, but when you are done with it, be sure to free it by executing pg_result -clear. Otherwise, you have a memory leak, and pgtcl will eventually start complaining that you have created too many command result objects.



The handle of the command result.


One of the following options, specifying which piece of result information to return:


The status of the result.


The error message, if the status indicates an error, otherwise an empty string.


The connection that produced the result.


If the command was an INSERT, the OID of the inserted row, otherwise 0.


The number of rows (tuples) returned by the query.


The number of rows (tuples) affected by the command.


The number of columns (attributes) in each row.

-assign arrayName

Assign the results to an array, using subscripts of the form (rowNumber, columnName).

-assignbyidx arrayName ?appendstr?

Assign the results to an array using the values of the first column and the names of the remaining column as keys. If appendstr is given then it is appended to each key. In short, all but the first column of each row are stored into the array, using subscripts of the form (firstColumnValue, columnNameAppendStr).

-getTuple rowNumber

Returns the columns of the indicated row in a list. Row numbers start at zero.

-tupleArray rowNumber arrayName

Stores the columns of the row in array arrayName, indexed by column names. Row numbers start at zero.


Returns a list of the names of the columns in the result.


Returns a list of sublists, {name typeOid typeSize} for each column.


Clear the command result object.

Return Value

The result depends on the selected option, as described above.

Submit correction

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.

Privacy Policy | About PostgreSQL
Copyright © 1996-2018 The PostgreSQL Global Development Group