PHP Manual
Prev |  | Next

# pg_lo_read

(PHP 4 >= 4.2.0, PHP 5)

pg_lo_read -- Read a large object

## Description

string pg_lo_read ( resource large_object [, int len] )

pg_lo_read() reads at most len bytes from a large object and returns it as a string.

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

> Note: This function used to be called pg_loread().

## Parameters

large_object

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

len

  An optional maximum number of bytes to return. Defaults to 8192.

## Return Values

A string containing len bytes from the large object, or `FALSE` on error.

## Examples

Example 1. pg_lo_read() example
`<?php $doc_oid = 189762345; $database = pg_connect("dbname=jacarta"); pg_query($database, "begin"); $handle = pg_lo_open($database, $doc_oid, "r"); $data = pg_lo_read($handle, 50000); pg_query($database, "commit"); echo $data; ?>`

## See Also

pg_lo_read_all()

Prev | Home | Next
pg_lo_read_all | Up | pg_lo_seek