pg_lo_write

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_write — Écrit un objet de grande taille PostgreSQL

Description

int pg_lo_write ( resource $large_object , string $data [, int $len ] )

pg_lo_write() écrit des données à l'intérieur d'un objet de grande taille à la position courante.

Pour manipuler un objet de grande taille (lo), il est nécessaire de placer les opérations dans un bloc de transaction.

Note:
Auparavant, cette fonction s'appelait pg_lowrite().

Liste de paramètres

large_object: Ressource objet de grande taille (LOB) PostgreSQL retournée par pg_lo_open().
data: Les données à être écrites dans l'objet de grande taille. Si len est spécifié et est inférieur à la grandeur de data, seul les len octets y seront écrits.
len: Un nombre maximal d'octets à écrire. Il doit être supérieur à zéro et inférieur à la grandeur de data. Cet argument est optionnel, s'il est omis, il prendra par défaut la grandeur de data.

Valeurs de retour

Le nombre d'octets écrit dans l'objet de grande taille ou FALSE en cas d'erreur.

Exemples

Exemple #1 Exemple avec pg_lo_write()

<?php
   $doc_oid = 189762345;
   $data = "Ceci écrasera le début de l'objet de grande taille.";
   $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");
?>

Voir aussi

pg_lo_create() - Crée un objet de grande taille PostgreSQL
pg_lo_open() - Ouvre un objet de grande taille PostgreSQL