pg_fetch_assoc

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

pg_fetch_assoc Lee una fila de resultado PostgreSQL como un array asociativo

Descripción

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

pg_fetch_assoc() devuelve un array asociativo que contiene la fila actual en el resultado result.

pg_fetch_assoc() es equivalente a llamar pg_fetch_row() con PGSQL_ASSOC como tercer argumento (que es opcional). Esto devolverá solo un array asociativo. Si se necesitan índices numéricos, se debe utilizar pg_fetch_row().

Nota: Esta función define los campos NULL al valor PHP null.

pg_fetch_assoc() no es significativamente más lenta que pg_fetch_row() y aporta una comodidad de uso apreciable.

Parámetros

result

Una instancia PgSql\Result, devuelta por pg_query(), pg_query_params(), o pg_execute() (entre otros).

row

Número de la fila a recuperar. Las filas están numeradas comenzando desde 0. Si el argumento es omitido o si es null, la siguiente fila es recuperada.

Valores devueltos

Un array con índice asociativo (por nombre de campo). Cada valor en el array es representado como un string. Los valores null de la base de datos son devueltos null.

false es devuelto si row excede el número de filas en el conjunto de resultados, no hay más filas disponibles o cualquier otro error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro result ahora espera una instancia de PgSql\Result ; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con pg_fetch_assoc()

<?php
$conn
= pg_pconnect ("dbname=publisher");
if (!
$conn) {
echo
"Ha ocurrido un error.\n";
exit;
}

$result = pg_query ($conn, "SELECT id, autor, email FROM autores");
if (!
$result) {
echo
"Ha ocurrido un error.\n";
exit;
}

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

Ver también