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_LONGaby zwrócić liczbowy stan parametruwynik, jak iPGSQL_STATUS_STRINGaby zwrócić oznaczenie parametruwynik. Jeśli nie podano,PGSQL_STATUS_LONGzostanie 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ę.
