pg_fetch_object

pg_fetch_object(PgSql\Result $result, [int $row], [string $class], [array $constructor_args]): object
```php

`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.

> [!NOTE]
> 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 con `pg_fetch_object`