Section courante

A propos

Section administrative du site

READ

Lecture
Cobol

Syntaxe

READ filename RECORD [INTO identifier]
[; AT END imperativestatement]
READ filename [NEXT] RECORD [WITH NO LOCK] [INTO identifier]
[; AT END imperativestatement]
READ filename RECORD [WITH NO LOCK] [INTO identifier]
[; KEY IS dataname]
[; INVALID KEY imperativestatement]

Paramètres

Nom Description
filename Ce paramètre permet d'indiquer le nom logique du fichier à partir duquel la lecture sera effectuée. Il doit correspondre à un fichier défini dans la clause SELECT du FILE-CONTROL.
RECORD Ce paramètre précise que l'on souhaite lire un enregistrement du fichier. Il s'agit d'une partie obligatoire dans la syntaxe de l'instruction READ.
NEXT Ce paramètre est utilisé pour indiquer que la lecture doit se faire sur l'enregistrement suivant du fichier, utile notamment dans le cas de fichiers indexés ou séquentiels.
WITH NO LOCK Ce paramètre permet d'effectuer la lecture sans verrouiller l'enregistrement, ce qui peut être utile dans les contextes multi-utilisateurs ou multi-processus.
INTO identifier Ce paramètre permet de copier le contenu de l'enregistrement lu dans une variable ou une structure spécifiée par l'identifiant. Cela permet de manipuler les données lues sans affecter directement le buffer du fichier.
AT END imperativestatement Ce paramètre permet de définir l'action à exécuter si aucun autre enregistrement n'est disponible à la lecture. Cela permet de gérer proprement la fin de fichier.
KEY IS dataname Ce paramètre permet de spécifier la clef d'accès utilisée pour localiser l'enregistrement dans un fichier indexé ou relatif. Il est nécessaire pour une lecture directe.
INVALID KEY imperativestatement Ce paramètre permet d'exécuter une instruction alternative si la lecture échoue à cause d'une erreur liée à une clé non trouvée, notamment dans les fichiers indexés.

Description

Cette instruction permet d'effectuer la lecture du prochain enregistrement disponible dans un fichier.

Remarques



Dernière mise à jour : Jeudi, le 28 juillet 2011