Obtém mensagem de erro associada ao resultado

# pg_result_error

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

pg_result_error — Obtém mensagem de erro associada ao resultado

### Descrição

function pg_result_error(PgSql\Result `$result`): string|false

pg_result_error() retorna qualquer mensagem de erro associada à instância de `result`. Portanto, o usuário tem mais chances de receber a mensagem de erro correta do que com pg_last_error().

A função pg_result_error_field() pode fornecer muito mais detalhes sobre erros de resultados do que pg_result_error().

Porque pg_query() retorna `false` se a consulta falhar, você deverá usar pg_send_query() e pg_get_result() para obter o identificador do resultado.

### Parâmetros

`result`
  Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).

### Valor Retornado

Retorna uma string. Retorna uma string vazia se não houver erro. Se houver um erro associado ao parâmetro `result`, retorna `false`.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `result` agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

### Exemplos

Exemplo #1 Exemplo de pg_result_error()

    <?php
      $dbconn = pg_connect("dbname=publisher") or die("Não foi possível conectar");

      if (!pg_connection_busy($dbconn)) {
          pg_send_query($dbconn, "select * from doesnotexist;");
      }

      $res1 = pg_get_result($dbconn);
      echo pg_result_error($res1);
    ?>

### Veja Também

- pg_result_error_field() - Retorna um campo individual de um relatório de erros
- pg_query() - Executa uma consulta
- pg_send_query() - Envia consulta assíncrona
- pg_get_result() - Obtém o resultado da consulta assíncrona
- pg_last_error() - Obtém a última string da mensagem de erro de uma conexão
- pg_last_notice() - Retorna a última mensagem de aviso do servidor PostgreSQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open