NUMVAL-C

Syntaxe

Paramètres

Description

Cette fonction permet de demander la valeur numérique d'une chaîne de caractères pouvant contenir des symboles ou des virgules devant le point décimal.

Remarques

• La fonction NUMVAL-C est conçue pour les environnements internationaux où les représentations numériques varient selon les conventions locales. Elle peut traiter des chaînes contenant des symboles monétaires (comme $, €,...) ou des virgules comme séparateurs de milliers, ce qui n'est pas possible avec la fonction NUMVAL standard.
• NUMVAL-C est particulièrement utile pour les applications financières, car elle permet d'analyser des entrées utilisateurs ou des données importées contenant des formats de devises. Par exemple, une chaîne comme "€1,234.56" peut être correctement interprétée en valeur numérique sans provoquer d'erreur de conversion.
• Le deuxième paramètre optionnel permet de spécifier un séparateur décimal personnalisé, ce qui est très utile dans les cas où le point (.) n'est pas utilisé comme séparateur. Par exemple, si une chaîne utilise la virgule comme séparateur décimal ("1.234,56"), ce paramètre permettra à NUMVAL-C d'en comprendre le sens correctement.
• L'utilisation de cette fonction améliore la robustesse des programmes COBOL face à des entrées variées et potentiellement mal formatées. Elle évite des erreurs de traitement pouvant survenir avec une conversion stricte imposée par d'autres fonctions.
• Comme toute fonction de conversion, NUMVAL-C peut générer une exception si la chaîne est trop mal formée pour être interprétée. Il est donc judicieux d'utiliser cette fonction avec des vérifications ou dans des structures de contrôle (par exemple, avec IF FUNCTION NUMVAL-C(...) NOT NUMERIC THEN ...).
• La fonction retourne une valeur numérique de type numeric, ce qui signifie qu'elle peut être utilisée directement dans des calculs arithmétiques ou des opérations conditionnelles, une fois la conversion effectuée avec succès.
• Il est recommandé d'utiliser NUMVAL-C plutôt que de coder manuellement le nettoyage de la chaîne, notamment dans les systèmes où les formats monétaires varient ou ne sont pas uniformes. Cela réduit la complexité du code et améliore sa lisibilité.
• NUMVAL-C est introduite dans des versions récentes du standard COBOL, donc il est important de s'assurer que l'environnement de compilation prend en charge cette fonction. Dans les versions plus anciennes, seule NUMVAL est disponible, avec des capacités plus limitées de gestion des formats.