php8.5
Home/ Manual/ pgsql / functions/ pg_lo_read

pg_lo_read

PHP function Edit on GitHub ✎

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

Read a large object

Description

pg_lo_read(PgSql\Lob $lob, int $length = 8192): string|false

pg_lo_read() reads at most length 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

lob

Lob

length

An optional maximum number of bytes to return.

Return Values

A string containing length bytes from the large object, or false on error.

Changelog

VersionDescription

Examples

pg_lo_read() example

php
<?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

Source: reference/pgsql/functions/pg-lo-read.xml · from the official PHP manual (php/doc-en)