cubrid_lob2_seek
(PECL CUBRID >= 8.4.1)
cubrid_lob2_seek — Déplace le curseur d'un objet LOB
Description
$lob_identifier
, int $offset
[, int $origin = CUBRID_CURSOR_CURRENT
] )
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, vous pouvez 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 vous utilisez la constante CUBRID_CURSOR_CURRENT pour le paramètre
origin, vous pouvez vous déplacer en avant ou en arrière.
L'argument offset peut être négatif ou positif.
Si vous utilisez la constante CUBRID_CURSOR_LAST pour le paramètre
origin, vous pouvez vous 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érer 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'objjet LOB.
Valeurs de retour
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
- cubrid_lob2_read() - Lit des données BLOB/CLOB
- cubrid_lob2_write() - Ecrit dans un objet LOB
- cubrid_lob2_seek64() - Déplace le curseur d'un objet LOB
- cubrid_lob2_tell() - Récupère la position du curseur dans un objet LOB
- cubrid_lob2_tell64() - Récupère la position du curseur dans l'objet LOB
- cubrid_lob2_size() - Récupère la taille d'un objet LOB
- cubrid_lob2_size64() - Récupère la taille d'un objet LOB
