pg_fetch_object
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_fetch_object — Busca uma linha como um objeto
Descrição
Nota: Esta função define campos NULL como o
valor null
do PHP.
Em termos de velocidade, a função é idêntica a
pg_fetch_array() e quase tão rápida quanto
pg_fetch_row() (a diferença é
insignificante).
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.
class
-
O nome da classe a ser instanciada, definir as propriedades e retornar.
Se não for especificado, um objeto stdClass será retornado.
constructor_args
-
Um array opcional de parâmetros a serem passados ao construtor
para objetos class
.
Valor Retornado
Um object com um atributo para cada nome de campo
no resultado. 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.
Erros/Exceções
Um ValueError é lançado quando
o constructor_args
não está vazio e a classe não possui construtor.
Exemplos
Exemplo #1 Exemplo de pg_fetch_object()
<?php
$database = "store";
$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
echo "Falha ao conectar ao banco de dados postgres $database\n";
exit;
}
$qu = pg_query($db_conn, "SELECT * FROM books ORDER BY author");
while ($data = pg_fetch_object($qu)) {
echo $data->author . " (";
echo $data->year . "): ";
echo $data->title . "<br />";
}
pg_free_result($qu);
pg_close($db_conn);
?>