Move o cursor de um objeto LOB

# cubrid_lob2_seek

(PECL CUBRID >= 8.4.1)

cubrid_lob2_seek — Move o cursor de um objeto LOB

### Descrição

function cubrid_lob2_seek(resource `$lob_identifier`, int `$offset`, int `$origin` = CUBRID_CURSOR_CURRENT): bool

A função cubrid_lob2_seek() é usada para mover a posição do cursor de um objeto LOB pelo valor definido no argumento `offset`, para a direção definida no argumento `origin`.

Para definir o argumento `origin`, pode-se usar `CUBRID_CURSOR_FIRST` para definir a posição do cursor avançando o número de unidades definidas por `offset` desde o primeiro início. Neste caso, `offset` precisa ser um valor positivo.

Se for usado `CUBRID_CURSOR_CURRENT` para `origin`, pode-se avançar ou retroceder e `offset` pode ser positivo ou negativo.

Se for usado `CUBRID_CURSOR_LAST` para `origin`, pode-se mover o número de unidades definido por `offset` para trás a partir do final do objeto LOB e `offset` pode ser somente positivo.

### Parâmetros

`lob_identifier`
  Identificador LOB como um resultado de cubrid_lob2_new() ou obtido do conjunto de resultados.
`offset`
  Número de unidades para mover o cursor.
`origin`
  Este parâmetro pode ter as seguintes constantes como valores: CUBRID_CURSOR_FIRST: move para frente desde o primeiro início. CUBRID_CURSOR_CURRENT: move para frente ou para trás desde a posição atual. CUBRID_CURSOR_LAST: move para trás desde o final do objeto LOB.

### Valor Retornado

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

### Exemplos

Exemplo #1 Exemplo de cubrid_lob2_seek()

    <?php
    // test_lob (id INT, contents CLOB)
    $conn = cubrid_connect("localhost", 33000, "demodb", "dba", "");

    cubrid_execute($conn,"DROP TABLE if exists test_lob");
    cubrid_execute($conn,"CREATE TABLE test_lob (id INT, contents CLOB)");
    $req = cubrid_prepare($conn, "INSERT INTO test_lob VALUES(2, ?)");

    $lob = cubrid_lob2_new($conn, 'CLOB');
    $len = cubrid_lob2_write($lob, "Hello world");

    cubrid_lob2_seek($lob, 0, CUBRID_CURSOR_LAST);
    cubrid_lob2_write($lob, "beautiful");

    cubrid_lob2_seek($lob, 15, CUBRID_CURSOR_FIRST);
    $data = cubrid_lob2_read($lob, 5);

    echo $data."\n";

    cubrid_lob2_bind($req, 1, $lob);
    cubrid_execute($req);

    cubrid_disconnect($conn);
    ?>

### Veja Também

- cubrid_lob2_read() - Lê bytes de dados BLOB/CLOB
- cubrid_lob2_write() - Escreve em um objeto LOB
- cubrid_lob2_seek64() - Move o cursor de um objeto LOB
- cubrid_lob2_tell() - Informa a posição do cursor do objeto LOB
- cubrid_lob2_tell64() - Informa a posição do cursor do objeto LOB
- cubrid_lob2_size() - Obtém o tamanho do objeto LOB
- cubrid_lob2_size64() - Obtém o tamanho do objeto LOB

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