RETURN |
Retour |
|---|---|
| Cobol | |
Syntaxe
|
RETURN sdfilename AT END statement END-RETURN |
Paramètres
| Nom | Description |
|---|---|
| sdfilename | Ce paramètre permet d'indiquer le nom logique du fichier de tri (déclaré dans la section SD - Sort Description). Il s'agit d'un fichier temporaire utilisé dans le cadre d'un tri avec l'instruction SORT, et qui sert ici comme source de lecture. Le RETURN sdfilename permet de lire un enregistrement trié un à un depuis ce fichier. Il est obligatoire pour spécifier d'où les enregistrements sont extraits. |
| AT END | Ce paramètre permet d'introduire une clause étant exécutée lorsque tous les enregistrements ont été lus depuis le fichier de tri. Dès que RETURN atteint la fin du fichier (EOF), le bloc d'instructions suivant AT END est exécuté. Cela permet de gérer proprement la fin de traitement, par exemple en terminant une boucle de lecture ou en déclenchant une action de clôture. |
| statement | Ce paramètre permet d'indiquer l'ensemble d'instructions COBOL à exécuter si la condition AT END est remplie, c'est-à-dire lorsqu'il n'y a plus d'enregistrement à lire. Cela peut inclure des actions comme la mise à jour d'un indicateur de fin, l'affichage d'un message, ou la transition vers une autre phase du programme. |
| END-RETURN | Ce paramètre permet de marquer la fin explicite du bloc RETURN. Il est requis dans les versions modernes de COBOL (comme COBOL 2002 ou Enterprise COBOL) lorsque RETURN est utilisé dans une structure IF...END-IF ou d'autres blocs structurés. Il améliore la lisibilité et la clarté du code, en définissant clairement les limites de la logique de retour d'enregistrement. |
Description
Cette instruction permet de récupérer un enregistrement lors de la sortie du programme.
Remarques
- RETURN est exclusivement utilisé avec les fichiers de tri temporaires : Contrairement à des fichiers classiques manipulés avec READ ou WRITE, l'instruction RETURN ne s'applique qu'aux fichiers définis dans la section SD (Sort Description), et ayant été générés par une opération SORT. C'est un mécanisme très spécifique du langage COBOL, lié à la gestion de fichiers intermédiaires.
- L'instruction permet de lire séquentiellement des enregistrements triés : Après avoir trié un fichier avec SORT, on utilise RETURN pour lire les résultats un par un. Cette approche permet un traitement structuré des données dans l'ordre souhaité, sans avoir besoin de créer ou manipuler un fichier physique sur le disque.
- La clause AT END est essentielle pour gérer la fin du fichier de tri : Sans cette clause, il serait difficile de savoir quand arrêter la lecture avec RETURN. AT END permet donc d'éviter une erreur de lecture ou une boucle infinie, en signalant la fin des données à traiter.
- L'instruction est souvent utilisée dans des boucles PERFORM ou READ : Typiquement, on encapsule l'appel à RETURN dans une boucle pour lire tous les enregistrements triés un à un. Lorsque le AT END est déclenché, on sort de la boucle. Cela rend la logique de lecture très claire et structurée.
- Le paramètre statement permet une gestion souple de la fin de lecture : Ce bloc peut contenir n'importe quelles instructions COBOL utiles à la logique métier, comme l'arrêt du programme, la réinitialisation de variables ou encore l'enchaînement vers une autre opération. Cela donne de la flexibilité dans le flux de contrôle.
- END-RETURN n'est pas toujours obligatoire mais recommandé : Bien que certains compilateurs COBOL autorisent de s'en passer, END-RETURN est conseillé dans les bonnes pratiques modernes. Il rend le code plus lisible et permet de bien identifier où commence et se termine la logique liée à RETURN.
- La lecture avec RETURN n'est pas aléatoire, mais linéaire : Contrairement à un READ avec accès direct (comme dans les fichiers indexés), RETURN ne permet pas de se positionner à un endroit spécifique. On parcourt les enregistrements les uns après les autres, dans l'ordre du tri effectué.
- Cette instruction montre bien la spécialisation de COBOL pour les traitements par lots : RETURN, comme SORT et UNSTRING, fait partie des instructions puissantes mais très ciblées du langage COBOL. Elle illustre comment COBOL a été conçu pour gérer des volumes massifs de données de manière structurée et contrôlée, notamment dans les applications bancaires ou administratives.
Dernière mise à jour : Jeudi, le 28 juillet 2011