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, 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

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