Manuel PHP
Précédent |  | Suivant

# 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 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()
pg_lo_open()

Précédent | Sommaire | Suivant
pg_lo_unlink | Niveau supérieur | pg_meta_data