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
pg_fetch_result() retorna o valor de uma determinada linha e campo (coluna) em uma instância PgSql\Result.
Note:
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
Example #1 Exemplo de pg_fetch_result()
<?php
$db = pg_connect("dbname=users user=me") || die();
$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