php man page for pg_lo_write

PG_LO_WRITE(3)															    PG_LO_WRITE(3)

pg_lo_write - Write to a large object

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

DESCRIPTION
       pg_lo_write(3) writes data into a large object at the current seek position.

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

       Note

	       This function used to be called pg_lowrite(3).

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

	      o $data
		-  The	data to be written to the large object. If $len is specified and is less than the length of $data, only $len bytes will be
		written.

	      o $len
		- An optional maximum number of bytes to write. Must be greater than zero and no greater than the length of $data. Defaults to the
		length of $data.

RETURN VALUES
	The number of bytes written to the large object, or FALSE on error.

EXAMPLES
       Example #1

	      pg_lo_write(3) example

	      <?php
		 $doc_oid = 189762345;
		 $data = "This will overwrite the start of the large object.";
		 $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");
	      ?>

SEE ALSO
       pg_lo_create(3), pg_lo_open(3).

PHP Documentation Group 													    PG_LO_WRITE(3)