pg_result

Nom

pg_result -- renvoie des informations sur le résultat d'une commande

Synopsis

pg_result poigneeResultat
optionResultat

Description

pg_result renvoie des informations sur un résultat de commande créé par un appel précédent à pg_exec.

Vous pouvez garder un résultat de commande aussi longtemps que vous en avez besoin, mais une fois terminé, assurez-vous de le libérer en exécutant pg_result -clear. Sinon, vous aurez des pertes de mémoire et pgtcl finira par se plaindre que vous avez créé trop d'objets de résultats de commandes.

Arguments

poigneeResultat

La poignée du résultat de la commande.

optionResultat

Une des options suivantes, spécifiant quelle sorte de résultat renvoyer :

-status

Le statut du résultat.

-error

Le message d'erreur si le statut indique une erreur, sinon une chaîne vide.

-conn

La connexion qui a produit ce résultat.

-oid

Si la commande était un INSERT, l'OID de la ligne insérée, sinon 0.

-numTuples

Le nombre de lignes (tuples) renvoyées par la requête.

-cmdTuples

Le nombre de lignes (tuples) affectées par la commande.

-numAttrs

Le nombre de colonnes (attributs) pour chaque ligne.

-assign arrayName

Affecte les résultats dans un tableau en utilisant des indices de la forme (numeroLigne, nomColonne).

-assignbyidx nomTableau ?appendstr?

Affecte les résultats dans un tableau en utilisant les valeurs de la première colonne et les noms des colonnes restantes comme clés. Si appendstr est donné, alors il est ajouté à chaque clé. En bref, tout sauf la première colonne de chaque ligne est stocké dans le tableau en utilisant des indices de la forme (valeurPremiereColonne, chaineAjouteeAuNomColonne).

-getTuple numeroLigne

Renvoie les colonnes de la ligne indiquée dans une liste. Les numéros de lignes commencent à zéro.

-tupleArray numeroLigne nomTableau

Stocke les colonnes de la ligne dans le tableau nomTableau, indexé par les noms de colonnes. Les numéros de lignes commencent à zéro.

-attributes

Renvoie une liste des noms des colonnes dans le résultat.

-lAttributes

Renvoie une liste de sous-listes, {name typeOid typeSize} pour chaque colonne.

-clear

Efface l'objet résultat de la commande.

Code de retour

Le résultat dépend de l'option sélectionnée comme décrit ci-dessus.