pg_fetch_assoc

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

pg_fetch_assoc — Busca 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().

Note: 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

Example #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