pg_result_status

Get status of query result

&reftitle.description; ``string``int```pg_result_status` `PgSql\Result` `result` `int` `mode` `PGSQL_STATUS_LONG`

`pg_result_status` returns the status of the `PgSql\Result` instance, or the PostgreSQL command completion tag associated with the result

&reftitle.parameters;

`result`

- &pgsql.parameter.result;

`mode`

- Either `PGSQL_STATUS_LONG` to return the numeric status of the `result`, or `PGSQL_STATUS_STRING` to return the command tag of the `result`. If not specified, `PGSQL_STATUS_LONG` is the default.

&reftitle.returnvalues;

Possible return values are `PGSQL_EMPTY_QUERY`, `PGSQL_COMMAND_OK`, `PGSQL_TUPLES_OK`, `PGSQL_COPY_OUT`, `PGSQL_COPY_IN`, `PGSQL_BAD_RESPONSE`, `PGSQL_NONFATAL_ERROR` and `PGSQL_FATAL_ERROR` if `PGSQL_STATUS_LONG` is specified. Otherwise, a `string` containing the PostgreSQL command tag is returned.

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.result-object;

&reftitle.examples;

### `pg_result_status` example

    <?php

    // Connect to the database
    $conn = pg_pconnect("dbname=publisher");

    // Execute a COPY
    $result = pg_query($conn, "COPY authors FROM STDIN;");

    // Get the result status
    $status = pg_result_status($result);

    // Determine status
    if ($status == PGSQL_COPY_IN)
       echo "Copy began.";
    else
       echo "Copy failed.";

    ?>

&example.outputs;

    Copy began.

&reftitle.seealso;

- `pg_connection_status`