Escribe un objeto de gran tamaño de PostgreSQL

# pg_lo_write

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_lo_write — Escribe un objeto de gran tamaño de PostgreSQL

### Descripción

function pg_lo_write(PgSql\Lob `$lob`, string `$data`, ?int `$length` = `null`): int|false

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.

> Nota:

> 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 #1 Ejemplo con pg_lo_write()

    <?php
       $doc_oid = 189762345;
       $data = "Esto sobrescribirá el inicio del objeto de gran tamaño.";
       $database = pg_connect("dbname=jacarta");
       pg_query($database, "begin");
       $handle = pg_lo_open($database, $doc_oid, "w");
       $data = pg_lo_write($handle, $data);
       pg_query($database, "commit");
    ?>

### Ver también

- pg_lo_create() - Crea un objeto de gran tamaño de PostgreSQL
- pg_lo_open() - Abre un objeto de gran tamaño de PostgreSQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open