array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.cubrid-lob2-seek.php', 1 => 'cubrid_lob2_seek', 2 => 'Déplace le curseur d\'un objet LOB', ), 'up' => array ( 0 => 'ref.cubrid.php', 1 => 'Fonctions 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' => 'fr', '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 — Déplace le curseur d'un objet LOB

Description

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

La fonction cubrid_lob2_seek() est utilisée pour déplacer la position du curseur d'un objet LOB d'un pas spécifié par l'argument offset, et dans la direction spécifiée par l'argument origin.

Pour définir l'argument origin, il est possible d'utiliser la constante CUBRID_CURSOR_FIRST pour déplacer en avant la position du curseur de offset unités depuis le début. Dans ce cas, offset doit être une valeur positive.

Si l'on utilise la constante CUBRID_CURSOR_CURRENT pour le paramètre origin, il est possible de se déplacer en avant ou en arrière. L'argument offset peut être négatif ou positif.

Si l'on utilise la constante CUBRID_CURSOR_LAST pour le paramètre origin, il est possible de se déplacer en arrière de offset unités depuis la fin de l'objet LOB ; l'argument offset peut seulement être positif dans ce cas.

Liste de paramètres

lob_identifier
Un identifiant LOB, résultant de la fonction cubrid_lob2_new() ou récupéré depuis le jeu de résultats.
offset
Nombre d'unités à utiliser pour déplacer le curseur.
origin
Ce paramètre peut prendre les valeurs suivantes : CUBRID_CURSOR_FIRST : Se déplace en avant depuis le début. CUBRID_CURSOR_CURRENT : Se déplace en avant ou en arrière, depuis la position courante. CUBRID_CURSOR_LAST : Se déplace en arrière depuis la fin de l'objet LOB.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec 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);
?>

Voir aussi