pg_lo_tell

Returns current seek position a of large object

&reftitle.description; `int` `pg_lo_tell` `resource` `large_object`

`pg_lo_tell` returns the current position (offset from the beginning) of a large object.

To use the large object interface, it is necessary to enclose it within a transaction block.

&reftitle.parameters;

`large_object`

- PostgreSQL large object (LOB) resource, returned by `pg_lo_open`.

&reftitle.returnvalues;

The current seek offset (in number of bytes) from the beginning of the large object. If there is an error, the return value is negative.

&reftitle.examples;

### `pg_lo_tell` example

    <?php
       $doc_oid = 189762345;
       $database = pg_connect("dbname=jacarta");
       pg_query($database, "begin");
       $handle = pg_lo_open($database, $doc_oid, "r");
       // Skip first 50000 bytes
       pg_lo_seek($handle, 50000, PGSQL_SEEK_SET);
       // See how far we've skipped
       $offset = pg_lo_tell($handle);
       echo "Seek position is: $offset";
       pg_query($database, "commit");
    ?>

&example.outputs;

    Seek position is: 50000

&reftitle.changelog;

&Version; | &Description;
5.6.0 | Added PostgreSQL 9.3's 64bit large object support. Both client and server must support PostgreSQL 9.3 and PHP must be 64bit build to use 64bit large object.

&reftitle.seealso;

- `pg_lo_seek`