pg_result_status

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

pg_result_status — Lee 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 de la instancia de PgSql\Result, o la etiqueta de comando PostgreSQL asociada 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

pg_connection_status() - Se lee el estado de la conexión PostgreSQL