pg_result_status

(PHP 4 >= 4.2.0, PHP 5)

pg_result_statusLit le statut du r�sultat

Description

mixed pg_result_status ( resource $result [, int $type ] )

pg_result_status() retourne le statut du r�sultat result ou la commande d'ex�cution de PostgreSQL associ�e au r�sultat.

Liste de param�tres

result

Ressource r�sultat de requ�te PostgreSQL, retourn� par pg_query(), pg_query_params() ou pg_execute() (entre autres).

type

Soit PGSQL_STATUS_LONG pour retourner un statut num�rique de result ou PGSQL_STATUS_STRING pour retourner le tag de la commande de result . Si l'argument n'est pas sp�cifi�, PGSQL_STATUS_LONG est la valeur par d�faut.

Valeurs de retour

Les valeurs de retour possibles sont PGSQL_EMPTY_QUERY, PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_COPY_OUT, PGSQL_COPY_IN, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR et PGSQL_FATAL_ERROR si PGSQL_STATUS_LONG est sp�cifi�. Autrement, une cha�ne contenant le tag de la commande PostgreSQL est retourn�.

Historique

Version Description
4.3.0 Le param�tre type a �t� ajout�.

Exemples

Exemple #1 Exemple avec pg_result_status()

<?php

// Connexion � la base de donn�es
$conn pg_pconnect("dbname=publisher");

// Ex�cution de COPY
$result pg_query($conn"COPY auteurs FROM STDIN;");

// R�cup�ration du statut
$status pg_result_status($result);

// D�termination du statut
if ($status == PGSQL_COPY_IN)
   echo 
"Le copiage a eu lieu.";
else
   echo 
"Le copiage a �chou�.";

?>

L'exemple ci-dessus va afficher :

Le copiage a eu lieu.

Voir aussi