pg_lo_write

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

pg_lo_writeÉcrit un objet de grande taille PostgreSQL

Description

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

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