pg_result_seek
pg_select
PostgreSQL-Funktionen
PHP Manual

# 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 das mit dem Ergebnis verknüpfte PostgreSQL Kommando-Tag, wenn die Abfrage erfolgreich war.

### Parameter-Liste

`result`

  PostgreSQL Ergebniskennung, 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 das PostgreSQL Kommando-Tag für das `result` zu erhalten. Falls nichts angegeben wurde, wird der Vorgabewert `PGSQL_STATUS_LONG` zurückgegeben.

### 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 das PostgreSQL Kommando-Tag enthält.

### Changelog

Version | Beschreibung
--- | ---
4.3.0 | Der Parameter `type` wurde hinzugefügt.

### 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 begonnen.

### Siehe auch

- pg_connection_status() - Gibt den Verbindungsstatus zurück

pg_result_seek
pg_select
PostgreSQL-Funktionen
PHP Manual