(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_write — Escreve em um objeto grande
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().
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
.
O número de bytes gravados no objeto grande, ou false
em caso de erro.
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.
|
Exemplo #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");
?>