pg_result

Nombre

pg_result -- obtiene informaci�n sobre el resultado de una consulta

Synopsis

pg_result handleResult opcionResult

Inputs

handleResult

Es el handle para el resultado de una consulta.

opcionResult

Especifica una de las varias posibles opciones.

Opciones

-status

el estado del resultado.

-error

el mensaje de error, si el estado indica error; de otro modo, un string vac�o.

-conn

la conexi�n que produjo el resultado.

-oid

si el comando fue un INSERT, el tuplo del OID insertado; de otro modo un string vac�o.

-numTuples

el n�mero de tuplos devueltos por la consulta.

-numAttrs

el n�mero de atributos en cada tuplo.

-assign nombreArray

asigna el resultado a un array, usando la forma (numTuplo,nombreAtributo).

-assignbyidx nombreArray ?appendstr?

asigna los resultado a un array usando el primer atributo del valor y el resto de nombres de atributos como claves. Si appendstr es pasado, entonces es a�adido a cada clave. Brevemente, todos excepto el primer campo de cada tuplo son almacenados en un array, usando una nomenclatura del tipo (valorPrimerCampo,nombreCampoAppendStr).

-getTuple numeroTuplo

devuelve los campos del tuplo indicado en una lista. Los n�meros de tuplo empiezan desde cero.

-tupleArray numeroTuplo nombreArray

almacena los campos del tuplo en el array nombreArray, indexados por nombres de campo. Los n�mero de tuplo empiezan desde cero.

-attributes

devuelve una lista con los nombre de los atributos del tuplo.

-lAttributes

devuelve una lista de sub-listas {nombre tipo tama�o} por cada atributo del tuplo.

-clear

elimina el objeto consulta resultante.

Outputs

el resultado depende de la opci�n elegida, como se describi� m�s arriba.

Descripci�n

pg_result devuelve informaci�n acerca del resultado de una consulta creada por un pg_exec anterior.

Puede mantener el resultado de una consulta en tanto en cuanto lo necesite, pero cuando haya terminado con �l aseg�rese de liberarlo ejecutando pg_result -clear. clear. De otro modo, tendr� un "agujero" en la memoria y Pgtcl mostrar� mensajes indicando que ha creado demasiados objetos consulta.