array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.cubrid-lob2-seek.php', 1 => 'cubrid_lob2_seek', 2 => 'Desplaza el cursor de un objeto LOB', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Funciones de CUBRID', ), 'prev' => array ( 0 => 'function.cubrid-lob2-read.php', 1 => 'cubrid_lob2_read', ), 'next' => array ( 0 => 'function.cubrid-lob2-seek64.php', 1 => 'cubrid_lob2_seek64', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/cubrid/functions/cubrid-lob2-seek.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

cubrid_lob2_seek

(PECL CUBRID >= 8.4.1)

cubrid_lob2_seek — Desplaza el cursor de un objeto LOB

Descripción

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

La función cubrid_lob2_seek() se utiliza para desplazar la posición del cursor de un objeto LOB según el argumento offset especificado, y en la dirección indicada por el argumento origin.

Para definir el argumento origin, puede utilizarse la constante CUBRID_CURSOR_FIRST para desplazar la posición del cursor offset unidades hacia adelante desde el inicio. En este caso, offset debe ser un valor positivo.

Si se utiliza la constante CUBRID_CURSOR_CURRENT para el parámetro origin, puede desplazarse hacia adelante o hacia atrás. El argumento offset puede ser negativo o positivo.

Si se utiliza la constante CUBRID_CURSOR_LAST para el parámetro origin, puede desplazarse hacia atrás offset unidades desde el final del objeto LOB; el argumento offset solo puede ser positivo en este caso.

Parámetros

lob_identifier
Un identificador LOB, resultado de la función cubrid_lob2_new() o recuperado desde el conjunto de resultados.
offset
Número de unidades a utilizar para desplazar el cursor.
origin
Este parámetro puede tomar los siguientes valores: CUBRID_CURSOR_FIRST: Se desplaza hacia adelante desde el inicio. CUBRID_CURSOR_CURRENT: Se desplaza hacia adelante o hacia atrás, desde la posición actual. CUBRID_CURSOR_LAST: Se desplaza hacia atrás desde el final del objeto LOB.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Ejemplos

Ejemplo #1 Ejemplo con 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);
?>

Ver también