ADD |
Ajouter |
|---|---|
| Cobol | |
Syntaxe
|
ADD identifier1 TO identifier2 [ROUNDED] [[ON] SIZE ERROR imperativestatement1] [NOT [ON] SIZE ERROR imperativestatement2] END-ADD |
|
ADD identifier1[,identifier1] TO identifier2 [ROUNDED] GIVING identifierm ROUNDED ON SIZE ERROR imperativestatement |
Paramètres
| Nom | Description |
|---|---|
| identifier1[,identifier1] | Ce paramètre permet d'indiquer la liste nom de l'identificateur à ajouter à la somme de l'addition. |
| identifier2 | Ce paramètre permet d'indiquer le nom de l'identificateur allant recevoir le résultat. |
| imperativestatement | Ce paramètre permet d'indiquer l'instruction traitant les erreurs de tailles de nombre. |
| ROUNDED | Ce paramètre permet d'indiquer que le résultat doit être arrondit. |
Description
Cette instruction permet l'addition d'une valeur numérique à une autre.
Remarques
- L'instruction ADD permet de réaliser une addition entre une ou plusieurs variables numériques : Elle est très utile pour cumuler des montants ou totaliser des données dans des traitements financiers, comptables ou statistiques. Elle permet ainsi de modifier directement le contenu d'une variable cible.
- Il est possible d'ajouter plusieurs identifiants à une seule variable en une seule instruction : En listant plusieurs identifier1 séparés par des virgules, COBOL additionne successivement ces valeurs au contenu de identifier2. Cela évite d'écrire plusieurs lignes de code.
- Le mot clef GIVING permet d'entreposer le résultat dans une variable différente sans modifier les opérandes : Cela permet de préserver les valeurs initiales et d'éviter les effets de bord. Le résultat est directement transféré dans identifierm.
- L'option ROUNDED permet d'arrondir le résultat de l'opération : Cela est particulièrement utile dans les calculs monétaires, où les décimales doivent être traitées avec précision pour éviter les erreurs d'arrondi qui s'accumulent dans de grandes opérations.
- La clause ON SIZE ERROR permet de capturer les débordements numériques : Elle est essentielle dans les traitements critiques, car elle empêche que le programme continue avec des données corrompues ou tronquées. On peut y insérer des instructions pour alerter, corriger ou arrêter l'exécution.
- La clause END-ADD est utilisée dans la version structurée du COBOL : Elle délimite la fin de l'instruction ADD lorsqu'on utilise des blocs d'instructions plus complexes. Elle améliore la lisibilité du code et facilite la maintenance.
- L'instruction ADD peut fonctionner aussi bien avec des variables qu'avec des valeurs littérales : Cela permet de l'utiliser dans des cas très variés : par exemple, ajouter 1 à une variable compteur, ou ajouter des montants dynamiques dans un rapport de gestion.
- L'option NOT ON SIZE ERROR permet de spécifier une action à faire en l'absence d'erreur : Cela rend l'instruction plus robuste, car on peut gérer les deux cas (avec ou sans erreur) de manière claire. Cela évite aussi de disperser la logique de traitement dans le programme.
Dernière mise à jour : Jeudi, le 28 juillet 2011