Escreve em um objeto grande

# pg_lo_write

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

pg_lo_write — Escreve em um objeto grande

### Descrição

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

pg_lo_write() grava dados em um objeto grande na posição de busca atual.

Para usar a interface de objeto grande, é necessário incluí-la em um bloco de transação.

> Nota:

> Esta função costumava ser chamada de pg_lowrite().

### Parâmetros

`lob`
  Uma instância de PgSql\Lob, retornada por pg_lo_open().
`data`

  Os dados a serem gravados no objeto grande. Se `length` for um int e for menor que o comprimento de `data`, apenas os bytes de `length` serão gravados.

`length`

  Um número máximo opcional de bytes a serem gravados. Deve ser maior que zero e não maior que o comprimento dos `data`. O padrão é o comprimento dos `data`.

### Valor Retornado

O número de bytes gravados no objeto grande, ou `false` em caso de erro.

### Registro de Alterações

Versão | Descrição
--- | ---
8.1.0 | O parâmetro `lob` agora espera uma instância de PgSql\Lob; anteriormente, um resource era esperado.
8.0.0 | `length` agora é anulável.

### Exemplos

Exemplo #1 Exemplo de pg_lo_write()

    <?php
       $doc_oid = 189762345;
       $data = "Isto irá substituir o início do objeto grande.";
       $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");
    ?>

### Veja Também

- pg_lo_create() - Cria um objeto grande
- pg_lo_open() - Abra um objeto grande

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