pg_lo_read

pg_lo_read(PgSql\Lob $lob, [int $length]): string
```php

`pg_lo_read` lee como máximo `length` bytes de un objeto de gran tamaño y devuelve los datos como un string.

Para utilizar un objeto de gran tamaño (`lo`), es necesario hacerlo dentro de una transacción.

> [!NOTE]
> Anteriormente, esta función se llamaba `pg_loread`.

## Parámetros

`lob`  
Una instancia `PgSql\Lob`, devuelta por `pg_lo_open`.

`length`  
Un número máximo de bytes a devolver. Este argumento es opcional.

## Valores devueltos

Una `string` que contiene `length` bytes del objeto de gran tamaño o `false` en caso de error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | El parámetro `lob` ahora espera una instancia de `PgSql\Lob` ; anteriormente, se esperaba un `resource`. |

## Ejemplos

Ejemplo con `pg_lo_read`