pg_fetch_assoc

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

pg_fetch_assocBusca uma linha como um array associativo

Descrição

pg_fetch_assoc(PgSql\Result $result, ?int $row = null): array|false

pg_fetch_assoc() retorna um array associativo que corresponde à linha buscada (registros).

pg_fetch_assoc() é equivalente a chamar pg_fetch_array() com PGSQL_ASSOC como o terceiro parâmetro opcional. Ele retorna apenas um array associativo. Se você precisar dos índices numéricos, use pg_fetch_row().

Nota: Esta função define campos NULL como o valor null do PHP.

pg_fetch_assoc() NÃO é significativamente mais lento do que usar pg_fetch_row() e é significativamente mais fácil de usar.

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 ou null, a próxima linha será buscada.

Valor Retornado

Um array indexado associativamente (por nome de campo). Cada valor no array é representado como uma string. Os valores NULL do banco de dados são retornados como null.

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

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_fetch_assoc()

<?php
$conn
= pg_connect("dbname=publisher");
if (!
$conn) {
echo
"Ocorreu um erro.\n";
exit;
}

$result = pg_query($conn, "SELECT id, author, email FROM authors");
if (!
$result) {
echo
"Ocorreu um erro.\n";
exit;
}

while (
$row = pg_fetch_assoc($result)) {
echo
$row['id'];
echo
$row['author'];
echo
$row['email'];
}
?>

Veja Também