If on "accident" your program passes pg_result_status a variable that is NOT a actual pg resource, it will return an empty string.
(This is important to know if you want to make sure a pg resource is "good" before attempting some operation on it).
pg_result_status
(PHP 4 >= 4.2.0, PHP 5)
pg_result_status — Zwraca stan wyniku zapytania
Opis
pg_result_status() zwraca stan identyfikatora wyniku, lub oznaczenie dopełnienia komendy, związane z wynikiem
Parametry
- wynik
-
Identyfikator wyniku zapytania PostgreSQL-a, zwrócony przez pg_query(), pg_query_params() lub pg_execute() (między innymi).
- typ
-
Zarówno PGSQL_STATUS_LONG aby zwrócić liczbowy stan parametru wynik , jak i PGSQL_STATUS_STRING aby zwrócić oznaczenie parametru wynik . Jeśli nie podano, PGSQL_STATUS_LONG zostanie domyślnie użyte.
Zwracane wartości
Możliwe zwracane wartości to: PGSQL_EMPTY_QUERY, PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_COPY_OUT, PGSQL_COPY_IN, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR oraz PGSQL_FATAL_ERROR gdy określono PGSQL_STATUS_LONG. W przeciwnym wypadku łańcuch (ang. string) zawierający oznaczenie komendy PostgreSQL-a jest zwracany.
Rejestr zmian
| Wersja | Opis |
|---|---|
| 4.3.0 | Parametr typ został dodany. |
Przykłady
Przykład #1 pg_result_status() - przykład
<?php
// Połącz się z bazą
$polaczenie = pg_pconnect("dbname=wydawca");
// Wykonaj COPY
$wynik = pg_query($polaczenie, "COPY autorzy FROM STDIN;");
// Pobierz stan wyniku
$stan = pg_result_status($wynik);
// Ustal stan
if ($stan == PGSQL_COPY_IN)
echo "Kopiowanie rozpoczęło się.";
else
echo "Kopiowanie nie powiodło się.";
?>
Powyższy przykład wyświetli:
Kopiowanie rozpoczęło się.
pg_result_status
09-Jun-2005 01:45
16-Oct-2002 01:29
0 = PGSQL_EMPTY_QUERY
1 = PGSQL_COMMAND_OK
2 = PGSQL_TUPLES_OK
3 = PGSQL_COPY_TO
4 = PGSQL_COPY_FROM
5 = PGSQL_BAD_RESPONSE
6 = PGSQL_NONFATAL_ERROR
7 = PGSQL_FATAL_ERROR
