pg_result_status

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_result_statusLee el estado del resultado

Descripción

pg_result_status(PgSql\Result $result, int $mode = PGSQL_STATUS_LONG): string|int

pg_result_status() devuelve el estado del resultado result o el comando de ejecución de PostgreSQL asociado al resultado.

Parámetros

result

An PgSql\Result instance, returned by pg_query(), pg_query_params() or pg_execute()(among others).

mode

Puede ser PGSQL_STATUS_LONG para devolver un estado numérico de result o PGSQL_STATUS_STRING para devolver la etiqueta del comando de result. Si el argumento no se especifica, PGSQL_STATUS_LONG es el valor por omisión.

Valores devueltos

Los valores de retorno posibles son PGSQL_EMPTY_QUERY, PGSQL_COMMAND_OK, PGSQL_TUPLES_OK, PGSQL_TUPLES_CHUNK, PGSQL_COPY_OUT, PGSQL_COPY_IN, PGSQL_BAD_RESPONSE, PGSQL_NONFATAL_ERROR y PGSQL_FATAL_ERROR si PGSQL_STATUS_LONG se especifica. De lo contrario, se devuelve un string que contiene la etiqueta del comando PostgreSQL.

Historial de cambios

Versión Descripción
8.1.0 The result parameter expects an PgSql\Result instance now; previously, a recurso was expected.

Ejemplos

Ejemplo #1 Ejemplo con pg_result_status()

<?php

// Conexión a la base de datos
$conn = pg_pconnect("dbname=publisher");

// Ejecución de COPY
$result = pg_query($conn, "COPY autores FROM STDIN;");

// Obtención del estado
$status = pg_result_status($result);

// Determinación del estado
if ($status == PGSQL_COPY_IN)
echo
"La copia se ha realizado.";
else
echo
"La copia ha fallado.";

?>

El resultado del ejemplo sería:

La copia se ha realizado.

Ver también