Cette fonction permet de récupérer la section correspondant à l'élément suivant de la liste définie par la section donnée en paramètre, dans le fichier de données.
Remarque importante : la dll PgExTool doit être chargée (ordre CHARGER_DLL) en début de programme et doit rester chargée au moment de l'appel des fonctions de gestion de listes de sections.
Paramètres
ALPHA(256) |
Fichier |
Nom complet du fichier de données. |
ALPHA(n) |
SectionListe |
Section liste. |
ALPHA(n) |
SectionElt |
Section élément de liste (mis à jour par la fonction) de type SectionListe#numéro ; il faut donc prévoir SectionElt plus grand que ce que contient SectionListe. |
NUM_BIN_4 |
TailleSection |
Taille de SectionElt : n. |
NUM_BIN_4 |
CodeRetour |
Code retour de lecture (mis à jour par la fonction). |
Valeurs possibles du code retour
0 |
Lecture réussie : SectionElt est alors renseignée et contient une section qui peut être utilisée dans les fonctions PgExToolReadValue et PgExToolWriteValue. |
Echec lors de la récupération de l'élément de la liste : SectionElt est retournée à blanc.
-1 |
Fichier paramètre non trouvé. |
-2 |
SectionListe invalide : - soit SectionListe est vide, - soit le fichier de données est un fichier paramètre destiné à un programme EXIT et SectionListe ne fait pas partie des sections autorisées. |
-4 |
SectionElt est trop petit pour recevoir le résultat de la fonction. |
-10 |
L'élément de liste souhaité n'existe pas : - soit le précédent positionnement dans la liste était sur le dernier élément de la liste ; par conséquent, il n'y a pas l'élément suivant. Dans ce cas, la fonction PgExToolItemSectionInUse retourne le dernier élément de la liste. - soit aucun positionnement dans la section liste n'a été effectué précédemment ; par conséquent, le positionnement sur l'élément suivant n'est pas autorisé. |
Exemple
/* Cet exemple correspond au parcours d'une liste dans un fichier paramètre
/* destiné à un programme EXIT lors d'une validation de correction
ALPHA(256) |
FicParam |
|
PARAM |
FicParam |
/* paramètre d'appel du programme EXIT |
ALPHA(40) |
SectionListe |
ALPHA(50) |
SectionElt |
NUM_BIN_4 |
TailleSection |
NUM_BIN_4 |
CodeRetour |
ALPHA(40) |
Cle |
ALPHA(200) |
Valeur |
/* Début de programme : chargement de la dll PgExTool
CHARGER_DLL 'PgExTool'
/* Parcours de la liste des objets reçus lors de la validation de correction
SectionListe = 'OBJET_RECU'
TailleSection = 50
/* lecture de la première section élément de la liste
APPELER_DLL 'PgExTool' 'PgExToolFirstItemSection' FicParam SectionListe SectionElt TailleSection CodeRetour
TANT_QUE CodeRetour = 0
/* il est alors possible de lire des paramètres liés à l'objet reçu
/* grâce à SectionElt ; par exemple le nom de l'objet reçu :
Cle = 'NOM'
TailleValeur = 200
APPELER_DLL 'PgExTool' 'PgExToolReadValue' FicParam SectionElt Cle Valeur TailleValeur CodeRetour
...
...
/* lecture de la section élément suivante (objet reçu suivant)
APPELER_DLL 'PgExTool' 'PgExToolNextItemSection' FicParam SectionListe SectionElt TailleSection CodeRetour
REFAIRE
/* Fin de programme : déchargement de la dll PgExTool
DECHARGER_DLL 'PgExTool'
Cliquez ci-dessous pour plus d'informations sur :
les programmes EXIT.