Introduction

Avec CPDB, vous pouvez parcourir votre base de données dans toutes les directions à l'aide de fonctions très simples et évoluées.

Pour parcourir votre base, vous pourrez utiliser un code telque celui-ci :

// Lecture du premier enregistrement
err = CPDB_LirePremier(mydbHandle);
while (err == 0)
{
  // Placez votre traitement ici
  // ...
  // Lecture de l'enregistrement suivant
  err = CPDB_LireSuivant(mydbHandle);
}

Cette boucle se terminera lorsque CPDB_LireSuivant retournera un message d'erreur (EOF : Fin de fichier). Vous devez alors controler que cette erreur est bien CPDB_ERR_EOF qui défini la fin de votre parcours. Vous pouvez parcourir votre base de données en sens inverse en utilisant CPDB_LireDernier et CPDB_LirePrecedent, le code de fin de parcours sera alors CPDB_ERR_BOF (début de fichier).

Pour parcourir page parpage, utilisez les fonctions CPDB_Avancer et CPDB_Reculer. Cet exemple vous montre un saut de 10 enregistrements en 1 seule opération :

err = CPDB_Avancer(mydbHandle, 10);

Note : si la fin (ou le début) du fichier est atteinte, l'opération de lecture est annulée, vous devrez alors effectué un CPDB_LirePremier (ou Dernier) afin de completer l'opération.

AA chaque instant il est possible de savoir si la dernière opération de parcours a réussi, pour celà utilisez la fonction CPDB_EstEndehors :

Boolean boolEstEndehors; err = CPDB_EstEndehors(iHandle, &boolEstEndehors);

Si boolEstEndehors est à vrai, la dernière the last browse operation have failed, and no record is currently readed.

CPDB_LirePremier

CPDB_LireSuivant

CPDB_LireDernier

CPDB_LirePrecedent

CPDB_Avancer

CPDB_Reculer

CPDB_EstEndehors

Haut

Site fonctionnant sous GuppY v3.1 - GNU Public License - © 2002-2024