pg_lo_write

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_write — Ecrit 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 2120. 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()
pg_lo_open()