pg_fetch_object

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_fetch_object — Lee una fila de resultado PostgreSQL en un objeto

Descripción

pg_fetch_object(
    PgSql\Result $result,
    ?int $row = null,
    string $class = "stdClass",
    array $constructor_args = []
): object|false

pg_fetch_object() devuelve un objeto con sus propiedades que corresponden a los nombres de los campos de la fila. La función puede instanciar opcionalmente un objeto de una clase específica y pasar los argumentos al constructor de dicha clase.

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

En cuanto a velocidad, la función es idéntica a pg_fetch_array() y es casi tan rápida como pg_fetch_row() (la diferencia es insignificante).

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 se numeran comenzando por 0. Si el argumento se omite o es null, se recupera la siguiente fila.
class: El nombre de la clase a instanciar, fija las propiedades de esta y sus valores de retorno. Si no se especifica nada, se devuelve un objeto de tipo stdClass.
constructor_args: Parámetro opcional de tipo array para pasar argumentos al constructor de la clase class.

Valores devueltos

Un objeto de tipo object con los atributos para cada campo en el conjunto de resultados. Los valores null de la base de datos se devuelven como null.

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

Errores/Excepciones

Se lanza una ValueError cuando el argumento constructor_args no está vacío y la clase no tiene constructor.

Historial de cambios

Versión	Descripción
8.3.0	Ahora lanza una excepción ValueError cuando el argumento `constructor_args` no está vacío y la clase no tiene constructor; anteriormente, se lanzaba una excepción Exception.
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_object()

<?php

$database = 'store';

$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
  echo "La conexión a la base $database ha fallado\n";
  exit;
}

$qu = pg_query($db_conn, "SELECT * FROM libros ORDER BY autor");

while ($data = pg_fetch_object($qu)) {
  echo $data->autor . " (";
  echo $data->anio . "): ";
  echo $data->titulo . "<br />";
}

pg_free_result($qu);
pg_close($db_conn);

?>

Ver también

pg_query() - Ejecuta una consulta PostgreSQL
pg_fetch_array() - Lee una línea de resultado PostgreSQL en un array
pg_fetch_assoc() - Lee una fila de resultado PostgreSQL como un array asociativo
pg_fetch_row() - Lee una fila en un array
pg_fetch_result() - Devuelve los valores de un resultado