DISPLAY-OF

Syntaxe

Paramètres

Description

Cette fonction permet de demander une chaîne de caractères alphanumérique correspondant au contenu du paramètre spécifié et retourne sa représentation avec le code de page spécifié.

Remarques

• La fonction DISPLAY-OF est utile pour garantir une conversion cohérente entre les formats binaires ou numériques et des chaînes de caractères affichables. Cela est particulièrement important lorsque vous devez afficher des données issues de calculs ou de champs internes du programme, tout en respectant un codage précis destiné à l'utilisateur final.
• Le paramètre arg1 est central dans cette fonction puisqu'il représente la valeur source à transformer. Celle-ci peut être de nature diverse - binaire, numérique, alphanumérique ou autre - ce qui rend la fonction très flexible pour l'affichage ou la transmission de données formatées dans une interface utilisateur ou un fichier de sortie.
• L'utilisation d'un deuxième paramètre (arg2) permet d'adapter le rendu de la chaîne résultante selon le jeu de caractères souhaité. Par exemple, dans des environnements multilingues ou distribués, vous pouvez spécifier un code de page particulier comme ASCII ou EBCDIC pour garantir que les caractères seront correctement affichés, quel que soit le système cible.
• DISPLAY-OF est souvent utilisée lorsqu'on souhaite afficher ou transférer des données dans des formats compatibles avec des systèmes externes. Grâce au paramètre de code de page, il devient plus simple de gérer les échanges entre systèmes hétérogènes sans risque de corruption des caractères ou d'incompatibilité d'encodage.
• En l'absence de arg2, la fonction utilisera le code de page par défaut de l'environnement d'exécution COBOL. Cela permet de simplifier la syntaxe lorsque le système est homogène ou lorsqu'il n'y a pas de contrainte particulière liée à l'encodage. Cependant, cela peut aussi représenter un risque si les données sont destinées à un environnement différent.
• Cette fonction se distingue d'un simple DISPLAY car elle ne produit pas directement un affichage à l'écran mais retourne une chaîne de caractères. Cela permet d'entreposer cette chaîne, de la manipuler ou de la combiner avec d'autres données avant d'être affichée, enregistrée ou transmise.
• L'utilisation de DISPLAY-OF est particulièrement recommandée dans les programmes COBOL qui gèrent des conversions de données pour des interfaces utilisateurs, des rapports imprimés ou des formats de fichiers texte. Elle garantit que les données seront représentées sous une forme lisible et standardisée, ce qui est crucial pour la lisibilité et la maintenance.
• En choisissant soigneusement arg2, on peut aussi adapter l'affichage pour différents marchés ou normes régionales. Par exemple, dans certains pays, des encodages particuliers sont requis pour les caractères spéciaux ou les alphabets non latins. DISPLAY-OF contribue ainsi à rendre les applications COBOL plus universelles et prêtes à l'internationalisation.