LENGTH

Syntaxe

Paramètres

Description

Cette fonction permet de demander le nombre de caractères que contient une chaîne de caractères.

Remarques

• La fonction LENGTH permet de connaître dynamiquement la taille réelle d'une chaîne de caractères. Contrairement à la taille déclarée dans le PIC, elle retourne le nombre de caractères effectivement présents, ce qui est utile pour des chaînes dont le contenu peut varier.
• Elle est particulièrement utile lorsqu'on travaille avec des entrées utilisateur ou des fichiers texte. Dans ces cas, la longueur du texte n'est pas toujours connue à l'avance, et LENGTH permet d'adapter les traitements en fonction de cette longueur réelle.
• Le paramètre chainedecaracteres peut être une variable ou une constante alphanumérique. Ce paramètre doit être correctement initialisé, car une variable vide ou non définie renverra une longueur nulle, ce qui pourrait fausser les calculs ou tests conditionnels.
• Cette fonction est essentielle dans les opérations de validation, notamment pour contrôler qu'un champ ne dépasse pas une taille limite. Par exemple, dans une application bancaire, on peut vérifier que le champ "nom du client" n'excède pas 30 caractères avant de l'enregistrer.
• Combinée à d'autres fonctions comme INSPECT, UNSTRING ou STRING, LENGTH permet une gestion fine des chaînes de caractères. Elle permet par exemple d'anticiper les dépassements de tampon ou de tronquer intelligemment une chaîne de caractères.
• LENGTH est également utile pour créer des boucles de traitement caractère par caractère. En connaissant la longueur exacte, on peut parcourir la chaîne de caractères sans risque de débordement mémoire ou d'accès à des positions invalides.
• La fonction LENGTH ne tient pas compte des espaces non significatifs à droite dans les chaînes de type alphanumérique. Cela signifie qu'une chaîne de caractères comme "ABC " peut être considérée comme ayant une longueur de 3 selon l'interprétation du compilateur, ce qui est à prendre en compte selon les besoins.
• Elle permet d'écrire des programmes plus robustes, surtout dans les systèmes COBOL modernes traitant des données issues d'interfaces ou de formats externes (JSON, XML,...). Savoir mesurer une chaîne à tout moment augmente la flexibilité du programme et réduit les erreurs liées à des suppositions de taille.