pg_fetch_array
(PHP 4, PHP 5)
pg_fetch_array — Retorna uma linha (registro) como um array
Descrição
pg_fetch_array() retorna um array que corresponde à linha (registro). Retorna FALSE se não existem mais linhas.
pg_fetch_array() é uma versão extendida de pg_fetch_row(). Além de armazenar os dados em índices numéricos (índice) no array resultante, também armazena os dados em chaves associativas (nome do campo) por padrão.
row é o número da linha (registro) a ser recuperado. A primeira linha é 0.
result_type é um parâmetro opcional que controla como o valor de retorno é iniciado. result_type é uma constante e pode ter os seguintes valores: PGSQL_ASSOC, PGSQL_NUM, e PGSQL_BOTH. pg_fetch_array() retorna um array associativo que tem o nome de campo como chave para PGSQL_ASSOC. Índice de campo como chave com PGSQL_NUM e ambos nome/índice numérico como chave com PGSQL_BOTH. O valor padrão é PGSQL_BOTH.
Nota: O parâmetro result_type foi adicionado no PHP 4.0.
pg_fetch_array() NÃO é significativamente mais lenta que pg_fetch_row(), e ainda fornece uma significativa facilidade de uso.
Example#1 Retornando linhas (registros) no PostgreSQL
<?php
$conn = pg_pconnect("dbname=publicar");
if (!$conn) {
echo "Um erro ocorreu.\n";
exit;
}
$result = pg_query($conn, "SELECT * FROM autores");
if (!$result) {
echo "Um erro ororreu.\n";
exit;
}
$arr = pg_fetch_array($result, 0, PGSQL_NUM);
echo $arr[0] . " <- array\n";
$arr = pg_fetch_array($result, 1, PGSQL_ASSOC);
echo $arr["autor"] . " <- array\n";
?>
Nota: A partir do PHP 4.1.0, row tornou-se opcional. A chamada pg_fetch_array() irá incrementar o contador de linha interno em 1.
Veja também pg_fetch_row(), pg_fetch_object() e pg_fetch_result().