PHP Handbuch
ZurückWeiter

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

Beispiel 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.

Siehe auch

pg_connection_status()

ZurückZum AnfangWeiter
pg_result_seekNach obenpg_select