Aponta para posição dentro de um objeto grande

# pg_lo_seek

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

pg_lo_seek — Aponta para posição dentro de um objeto grande

### Descrição

function pg_lo_seek(PgSql\Lob `$lob`, int `$offset`, int `$whence` = `SEEK_CUR`): bool

pg_lo_seek() seeks a position within an PgSql\Lob instance.

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

### Parâmetros

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

  A posição em bytes para apontar.

`whence`

  Uma das constantes `PGSQL_SEEK_SET` (aponta a partir do início do objeto), `PGSQL_SEEK_CUR` (aponta a partir da posição atual) ou `PGSQL_SEEK_END` (aponta a partir do final do objeto).

### Valor Retornado

Retorna `true` em caso de sucesso ou `false` em caso de falha.

### 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_seek()

    <?php
       $doc_oid = 189762345;
       $database = pg_connect("dbname=jacarta");
       pg_query($database, "begin");
       $handle = pg_lo_open($database, $doc_oid, "r");
       // Ignora os primeiros 50.000 bytes
       pg_lo_seek($handle, 50000, PGSQL_SEEK_SET);
       // Lê os próximos 10.000 bytes
       $data = pg_lo_read($handle, 10000);
       pg_query($database, "commit");
       echo $data;
    ?>

### Veja Também

- pg_lo_tell() - Retorna a posição de busca atual a de um objeto grande

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open