(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_array — Lee una línea de resultado PostgreSQL en un array
pg_fetch_array() devuelve un array que contiene la línea solicitada.
pg_fetch_array() es una versión mejorada de pg_fetch_row(). Además de proporcionar un array con índice numérico, también puede almacenar los datos en un array asociativo, utilizando los nombres de los campos como claves. Estas dos funciones utilizan el array asociativo por omisión.
Nota: Esta función define campos NULOS al valor
null
de PHP.
pg_fetch_array() no es significativamente más lenta que pg_fetch_row() y aporta una comodidad de uso apreciable.
result
An PgSql\Result instance, returned by pg_query(), pg_query_params() or pg_execute()(among others).
row
Número de la línea a recuperar. Las líneas están numeradas
comenzando por 0. Si el argumento es omitido o si vale null
,
se recupera la línea siguiente.
mode
An optional parameter that controls how the returned array is indexed.
mode
is a constant and can take the following values:
PGSQL_ASSOC
, PGSQL_NUM
and PGSQL_BOTH
.
Using PGSQL_NUM
, the function will return an array with numerical indices,
using PGSQL_ASSOC
it will return only associative indices
while PGSQL_BOTH
will return both numerical and associative indices.
Un array con índice numérico (comenzando por 0), asociativo (indexado con
el nombre de los campos) o ambos.
Cada valor en el array está representado como un string
(string). Los valores null
de la base de datos son
devueltos como null
.
false
es devuelto si row
excede el número de
líneas en el conjunto de resultados, no hay más líneas disponibles o cualquier
otro error.
Intentar recuperar el resultado de una consulta que no sea SELECT también devolverá false
.
Versión | Descripción |
---|---|
8.1.0 |
The result parameter expects an PgSql\Result
instance now; previously, a recurso was expected.
|
Ejemplo #1 Ejemplo con pg_fetch_array()
<?php
$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
echo "Error de conexión.\n";
exit;
}
$result = pg_query ($conn, "SELECT autor, email FROM autores");
if (!$result) {
echo "Error durante la consulta.\n";
exit;
}
$arr = pg_fetch_array ($result, 0, PGSQL_NUM);
echo $arr[0] . " <- Línea 1 Autor\n";
echo $arr[1] . " <- Línea 1 Correo electrónico\n";
// El parámetro row es opcional; NULL puede ser pasado en su lugar,
// para pasar un modo. Las llamadas sucesivas a pg_fetch_array
// devolverán la línea siguiente.
$arr = pg_fetch_array($result, NULL, PGSQL_ASSOC);
echo $arr["autor"] . " <- Línea 2 Autor\n";
echo $arr["email"] . " <- Línea 2 Correo electrónico\n";
$arr = pg_fetch_array($result);
echo $arr["autor"] . " <- Línea 3 Autor\n";
echo $arr[1] . " <- Línea 3 Correo electrónico\n";
?>