CascadiaPHP 2024

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.

Nota:

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

Exemplo #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

add a note

User Contributed Notes 1 note

up
-2
bobahspb at gmail dot com
12 years ago
Be careful: pg_lo_export() create empty file without "begin"/"end".
See docs: "...it is necessary to enclose it within a transaction block..."
To Top