pg_lo_write

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

pg_lo_writeEscribe un objeto de gran tamaño de PostgreSQL

Descripción

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

An PgSql\Lob instance, returned by 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 The lob parameter expects an PgSql\Lob instance now; previously, a recurso was expected.
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