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.