Passe à la ligne suivante (c'est-à-dire à l'enregistrement suivant) du résultat de la requête.
Lors du premier appel de la fonction SQLAvance (également nommée SQLFetch), l'enregistrement en cours sera le premier des enregistrements sélectionnés par la requête.
Cette fonction permet de parcourir le résultat de la requête "ligne à ligne". Pour plus de détails sur les différents types de parcours du résultat d'une requête, consultez
Types de parcours SQL.
Syntaxe
<Résultat> = SQLAvance(<Nom de la requête>)
<Résultat> : Entier
0 si la lecture de l'enregistrement s'est bien passée. Les données peuvent être récupérées avec les fonctions SQLLitCol et SQLLitMémo.
<Nom de la requête> : Chaîne de caractères
- Nom de la requête créée et exécutée avec la fonction SQLExec,
- Nom de la requête exécutée avec la fonction SQLExecWDR.
Remarques
SQLAvance/SQLFetch : Récupération partiel du résultat de la requête
La fonction
SQLAvance ne lance pas la récupération de toutes les lignes du résultat de la requête : seul l'enregistrement en cours est récupéré par la fonction
SQLAvance.
Par conséquent, la récupération du nombre total de lignes du résultat (
SQL.NbLig) avec la fonction
SQLInfoGene n'est pas possible si la fonction
SQLAvance est utilisée pour parcourir le résultat.