pg_lo_read

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

pg_lo_readLê um objeto grande

Descrição

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

pg_lo_read() lê no máximo length bytes de um objeto grande e o retorna como uma string.

Para usar a interface de objeto grande, é necessário incluí-la em um bloco de transação.

Note:

Esta função costumava ser chamada de pg_loread().

Parâmetros

lob

Uma instância de PgSql\Lob, retornada por pg_lo_open().

length

Um número máximo opcional de bytes a serem retornados.

Valor Retornado

Uma string contendo bytes de length do objeto grande, ou false por erro.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro lob agora espera uma instância de PgSql\Lob; anteriormente, um resource era esperado.

Exemplos

Example #1 Exemplo de pg_lo_read()

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

Veja Também

  • pg_lo_read_all() - Lê um objeto grande inteiro e envia direto para o navegador