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

Una instancia PgSql\Result, devuelta por pg_query(), pg_query_params(), o pg_execute() (entre otros).

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 El parámetro result ahora espera una instancia de PgSql\Result ; anteriormente, se esperaba un resource.

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 ejemplo anterior mostrará :

La copia se ha realizado.

Ver también