END-STRING |
Fin de chaîne de caractères |
|---|---|
| Cobol | |
Syntaxe
|
STRING identifier1 DELIMITED [BY] (identifier2|SIZE) INTO identifier3 [[WITH] POINTER identifier4] [[ON] OVERFLOW statementlist] [NOT [ON] OVERFLOW statementlist] [END-STRING] |
Paramètres
| Nom | Description |
|---|---|
| identifier1 | Ce paramètre représente la variable ou le champ dont la valeur sera convertie ou concaténée dans une nouvelle chaîne de caractères. |
| DELIMITED BY | Ce paramètre spécifie la délimitation de la chaîne de caractères source, indiquant où la concaténation s'arrête (par exemple, jusqu'à la fin de identifier2). |
| identifier2 | Ce paramètre désigne la variable qui sert de délimiteur ou la taille du champ jusqu'à laquelle la concaténation doit être effectuée. |
| SIZE | Ce paramètre peut être utilisé comme alternative à un délimiteur, permettant de spécifier la taille exacte de la chaîne à concaténer. |
| INTO identifier3 | Ce paramètre indique où la chaîne de caractères résultante sera entreposée après la concaténation des valeurs de identifier1 et identifier2. |
| POINTER identifier4 | Ce paramètre permet de spécifier un pointeur indiquant la position où la chaîne concaténée doit être insérée ou modifiée. |
| OVERFLOW | Ce paramètre déclenche l'exécution d'une ou plusieurs instructions spécifiées par statementlist en cas de dépassement de la capacité de la chaîne de caractères. |
Description
Cette instruction permet d'indiquer la fin d'une instruction STRING.
Remarques
- L'instruction END-STRING marque la fin d'une opération de concaténation de chaînes de caractères dans COBOL. Elle permet de signaler la fin du processus de création ou de modification d'une chaîne en combinant plusieurs éléments selon les paramètres spécifiés dans la commande STRING.
- Le paramètre identifier1 représente la variable ou champ source qui contient les données à concaténer. C'est à partir de cette variable que le processus de concatenation démarre, et son contenu est ajouté à une nouvelle chaîne de caractères.
- DELIMITED BY est un paramètre clef dans l'instruction STRING, puisqu'il spécifie un délimiteur, soit une variable, soit une taille, déterminant où la chaîne de caractères source doit se terminer. Cela permet de découper la chaîne à la position spécifiée par le délimiteur.
- Le paramètre SIZE peut être utilisé comme alternative à un délimiteur pour indiquer la longueur exacte de la chaîne à copier ou à concaténer. Ce paramètre est utile lorsque le délimiteur physique, comme une variable, n'est pas disponible.
- INTO identifier3 définit la cible de la concaténation, c'est-à-dire où la chaîne résultante sera stockée après l'opération. Cela permet de manipuler des chaînes de caractères et de les affecter à de nouvelles variables pour un traitement ultérieur.
- Le paramètre POINTER identifier4 est facultatif et indique la position à laquelle les données doivent être insérées dans la chaîne cible. Cela permet de gérer de manière précise la manière dont les chaînes sont insérées dans la variable de destination.
- Le paramètre OVERFLOW spécifie les actions à exécuter en cas de dépassement de la capacité de la chaîne cible. Si la taille de la chaîne dépasse la limite allouée, un ensemble d'instructions (définies dans statementlist) sera exécuté, offrant ainsi une gestion des erreurs plus détaillée.
- L'instruction END-STRING est essentielle pour délimiter le bloc de code de la concaténation, indiquant que l'ensemble des manipulations de chaîne est terminé. Elle permet de garantir que toutes les opérations sont effectuées correctement avant de continuer avec d'autres instructions dans le programme.
Dernière mise à jour : Jeudi, le 28 juillet 2011