pg_fetch_array

(PHP 3>= 3.0.1, PHP 4 )

pg_fetch_array -- Pega uma linha como um array

Descrição

array pg_fetch_array ( recurso resultado, int linha [, int tipo_de_resultado])

pg_fetch_array() retorna uma array que corresponde 'a linha pega (registro). Ela 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 (index de campo) na array de resultado, ela também armazena os dados em índices associativos (nome do campo) por padrão.

linha é o número da linha (registro) a ser recuperado. A primeira linha é 0.

tipo_de_resultado é um parâmetro opicional que controla como o valor de retorno é iniciado tipo_de_resultado é uma constante e pode ter os seguintes valores: PGSQL_ASSOC, PGSQL_NUM, e PGSQL_BOTH. pg_fetch_array() retorna uma array associativa que tem o nome de campo como chave para PGSQL_ASSOC. Index de campo como chave com PGSQL_NUM e ambos nome/index como chave com PGSQL_BOTH. O valor padrão é PGSQL_BOTH.

Nota: tipo_de_resultado foi adicionado no PHP 4.0.

pg_fetch_array() NÃO é significativamente mais lento do que usar pg_fetch_row(), enquanto ele fornece uma significativa facilidade de uso.

Veja também pg_fetch_row() e pg_fetch_object() e pg_fetch_result().

Exemplo 1. PostgreSQL fetch array

<?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, linha tornou-se opcional. A chamada pg_fetch_array() irá incrementar o contador de linha interno em 1.