PG_LO_SEEK(3)															     PG_LO_SEEK(3)

pg_lo_seek - Seeks position within a large object

SYNOPSIS

       bool pg_lo_seek (resource  $large_object, int  $offset, [int  $whence = PGSQL_SEEK_CUR])

DESCRIPTION

       pg_lo_seek(3) seeks a position within a large object resource.

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

PARAMETERS

	      o $large_object
		- PostgreSQL large object (LOB) resource, returned by pg_lo_open(3).

	      o $offset
		- The number of bytes to seek.

	      o $whence
		-  One	of  the  constants  PGSQL_SEEK_SET (seek from object start), PGSQL_SEEK_CUR (seek from current position) or PGSQL_SEEK_END
		(seek from object end) .

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      pg_lo_seek(3) 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);
		 // Read the next 10000 bytes
		 $data = pg_lo_read($handle, 10000);
		 pg_query($database, "commit");
		 echo $data;
	      ?>

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.6.0	|						    |
       |	|						    |
       |	|  Added PostgreSQL 9.3's 64bit large  object  sup- |
       |	| port.  Both  client and server must support Post- |
       |	| greSQL 9.3 and PHP must be  64bit  build  to	use |
       |	| 64bit large object.				    |
       |	|						    |
       +--------+---------------------------------------------------+
SEE ALSO

       pg_lo_tell(3).

PHP Documentation Group 													     PG_LO_SEEK(3)