pg_lo_write

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

`pg_lo_write` escribe datos dentro de un objeto de gran tamaño en la posición actual.

Para manipular un objeto de gran tamaño (`lo`), es necesario colocar las operaciones dentro de un bloque de transacción.

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

## Parámetros

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

`data`  
Los datos a ser escritos en el objeto de gran tamaño. Si `length` es un `int` y es inferior al tamaño de `data`, solo los primeros `length` bytes serán escritos.

`length`  
Un número máximo de bytes a escribir. Debe ser superior a cero y menor al tamaño de `data`. Este argumento es opcional; si se omite, tomará por defecto el tamaño de `data`.

## Valores devueltos

El número de bytes escritos en el 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`. |
| 8.0.0 | `connection` es ahora nullable. |

## Ejemplos

Ejemplo con `pg_lo_write`