pg_lo_tell

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_tell --  Gibt die aktuelle Lese- oder Schreibposition in einem Large Object zurück

Beschreibung

int pg_lo_tell ( resource large_object )

pg_lo_tell() gibt die aktuelle Position (Offset vom Anfang des Large Objects aus) des internen Zeigers zurück.

Um die Large Object (lo) Schnittstelle benutzen zu können, müssen die Kommandos innerhalb einer Transaktion ausgeführt werden.

Parameter Liste

large_object

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

Rückgabewerte

Die aktuelle Lese- oder Schreibposition in einem (in Bytes) vom Anfang des Large Objects aus. Falls ein Fehler auftritt, ist der Rückgabewert negativ.

Beispiele

Beispiel 1. pg_lo_tell() Beispiel

<?php
   $doc_oid
= 189762345;
   
$database = pg_connect("dbname=jacarta");
   
pg_query($database, "begin");
   
$handle = pg_lo_open($database, $doc_oid, "r");
   
// Überspringe die ersten 50000 Bytes
   
pg_lo_seek($handle, 50000, PGSQL_SEEK_SET);
   
// Test, wieviele Bytes übersprungen wurden
   
$offset = pg_lo_tell($handle);
   echo
"Die aktuelle Position ist: $offset";
   
pg_query($database, "commit");
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Die aktuelle Position ist: 50000

Siehe auch

pg_lo_seek()