pg_lo_write

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

pg_lo_write — Escreve em um objeto grande

Descrição

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.

Note:

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

Example #1 Exemplo de pg_lo_write()

<?php
   $doc_oid = 189762345;
   $data = "This will overwrite the start of the large object.";
   $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