Function.pg-lo-write

Aus PHP-Wiki

pg_lo_write — Schreibt in ein Large Object

Beschreibung

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

pg_lo_write() schreibt Daten ab der aktuellen Position der internen Schreib-Lese-Marke in ein Large Object. Um die Large Object (lo) Schnittstelle benutzen zu können, müssen die Kommandos innerhalb einer Transaktion ausgeführt werden. Hinweis: Diese Funktion ersetzt die Funktion pg_lowrite()().

Parameter-Liste

large_object

• PostgreSQL Large Object Ressource (LOB), die von der Funktion pg_lo_open() zurückgegeben wurde.

data

• Die Daten, die in das Large Object geschrieben werden. Falls len angegeben wurde und kleiner als die Länge von data ist, werden nur len Bytes geschrieben.

len

• Die maximale Anzahl der Bytes, die geschrieben werden. Die Anzahl muss grösser als 0 und kleiner als die Länge von data sein. Der Vorgabewert ist die Länge von data . Diese Angabe ist optional.

Rückgabewerte

Die Anzahl der Bytes, die in das Large Object geschrieben wurden oder FALSE, falls ein Fehler auftrat.

Beispiele

Beispiel #1 pg_lo_write() Beispiel

<?php
   $doc_oid = 189762345;
   $data = "Hiermit wird der Anfang des Large Objects überschrieben.";
   $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");
?>

Siehe auch

• pg_lo_create()
• pg_lo_open()