cubrid_lob2_seek

(PECL CUBRID >= 8.4.1)

cubrid_lob2_seek — Move o cursor de um objeto LOB

Descrição

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

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