pg_result_seek
pg_select
Fonctions PostgreSQL
PHP Manual

# pg_result_status

(PHP 4 >= 4.2.0, PHP 5)

pg_result_status — Lit 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

- pg_connection_status() - Lit le statut de la connexion PostgreSQL

pg_result_seek
pg_select
Fonctions PostgreSQL
PHP Manual