Retorna valores de uma instância de resultado

# pg_fetch_result

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

pg_fetch_result — Retorna valores de uma instância de resultado

### Descrição

function pg_fetch_result(PgSql\Result `$result`, string|false|null `$row`, mixed `$field`): string|false|null
function pg_fetch_result(PgSql\Result `$result`, mixed `$field`): string|false|null

pg_fetch_result() retorna o valor de uma determinada linha e campo (coluna) em uma instância PgSql\Result.

> Nota:

> Esta função costumava ser chamada de pg_result().

### Parâmetros

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

  Número da linha no resultado a ser buscado. As linhas são numeradas de 0 para cima. Se omitido, a próxima linha será buscada.

`field`

  Uma string representando o nome do campo (coluna) a ser buscado, caso contrário, um int representando o número do campo a ser buscado. Os campos são numerados de 0 para cima.

### Valor Retornado

Booleano é retornado como "t" ou "f". Todos os outros tipos, incluindo arrays, são retornados como strings formatadas da mesma maneira padrão do PostgreSQL que você veria no programa psql. Os valores `NULL` do banco de dados são retornados como `null`.

`false` é retornado se `row` exceder o número de linhas no conjunto ou em qualquer outro erro.

### Registro de Alterações

Versão | Descrição
--- | ---
8.3.0 | `row` agora é anulável.
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_fetch_result()

    <?php
    $db = pg_connect("dbname=users user=me");

    $res = pg_query($db, "SELECT 1 UNION ALL SELECT 2");

    $val = pg_fetch_result($res, 1, 0);

    echo "O primeiro campo da segunda linha é: ", $val, "\n";
    ?>

O exemplo acima produzirá:

    O primeiro campo da segunda linha é: 2

### Veja Também

- pg_query() - Executa uma consulta
- pg_fetch_array() - Busca uma linha como um array

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