Forum und email

pg_result_status

(PHP 4 >= 4.2.0, PHP 5)

pg_result_status — Gibt den Status eines Abfrageergebnisses zurück

Beschreibung

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

pg_result_status() gibt den Status eines Abfrageergebnisses zurück oder einen string, der eine PostgreSQL Meldung enthält, die mit dem Abfrageergebnis verknüpft ist.

Parameter Liste

result

PostgreSQL Verbindungskennung, die (unter anderem) von den Funktionen pg_query(), pg_query_params() oder pg_execute() zurückgegeben wurde.

type

Entweder PGSQL_STATUS_LONG, um die Statusnummer von result zu erhalten, oder PGSQL_STATUS_STRING, um eine PostgreSQL-Meldung für das result zu erhalten. Falls nichts angegeben wurde, wird der Vorgabewert PGSQL_STATUS_LONG übergeben.

Rückgabewerte

Mögliche Rückgabewerte sind PGSQL_EMPTY_QUERY, PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_COPY_OUT, PGSQL_COPY_IN, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR und PGSQL_FATAL_ERROR, falls PGSQL_STATUS_LONG angegeben wurde. Anderenfalls wird ein string zurückgegeben, der die PostgreSQL-Meldung enthält.

Beispiele

Example#1 pg_result_status() Beispiel

<?php

// Zur Datenbank verbinden
$conn pg_pconnect("dbname=publisher");

// Eine Abfrage ausführen
$result pg_query($conn"COPY authors FROM STDIN;");

// Den Status des Abfrageergebnisses holen
$status pg_result_status($result);

// Den Status ermitteln
if ($status == PGSQL_COPY_IN)
   echo 
"Copy begonnen.";
else
   echo 
"Copy fehlgeschlagen.";
 
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Copy began.