Forum und email

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

Example#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");
?>