Fonctions

Les fonctions sont des routines intégrées qui acceptent un certain nombre de paramètres et qui renvoient une seule valeur. Elles servent à manipuler le contenu des champs et les variables utilisés dans les commandes.

Remarque

Les fonctions ne modifient pas les données dans les champs ; elles génèrent et renvoient une nouvelle valeur à partir d'un calcul ou d'un algorithme qui utilise les données des champs ou des variables comme entrées. Utilisez la valeur renvoyée par la fonction comme entrée pour une commande.

Syntaxe des fonctions

Les fonctions commencent par un nom de fonction suivi directement d'une parenthèse ouvrante, d'une liste séparée par des virgules d'au moins 0 valeurs transmises à la fonction sous forme d'arguments, ainsi que d'une parenthèse fermante.

Exemple

La fonction BETWEEN(valeur; min; max) prend trois arguments et renvoie « vrai » si la valeur tombe dans la plage ou « faux » si elle ne tombe pas dans la plage :

  • valeur : l'expression ou le champ à tester
  • min : le minimum de la plage
  • max : le maximum de la plage
BETWEEN(montant; 500; 5000)

Arguments des fonctions

Un argument de fonction est une valeur d'introduction spécifique transmise à la fonction.

Les arguments des fonctions sont transmis aux fonctions via une liste d'arguments. Il s'agit d'une liste délimitée par des virgules contenant des valeurs littérales, des variables ou des expressions évaluées sur les valeurs du type de données des paramètres. Pour obtenir plus d'informations sur l'utilisation des types de données, consultez la rubrique Types de données.

Remarque

Si votre projet utilise des formats numériques européens ou que vous écrivez des scripts portables dans toutes les régions, séparez les arguments de fonction par un caractère espace plutôt que par une virgule sauf si vous transmettez une valeur numérique signée. Les fonctions acceptant des valeurs numériques signées nécessitent un délimiteur explicite.

Fonctions et commandes

La différence entre une commande et une fonction est subtile, mais essentielle pour utiliser ACLScript :

Fonctions Commandes
Utilisent des champs, des valeurs ou des enregistrements comme valeurs d'entrée et génèrent une nouvelle valeur renvoyée. Utilisent les tables comme valeur d'entrée et génèrent de nouveaux enregistrements et de nouvelles tables.
Utilisées dans les expressions, champs calculés, valeurs de paramètres de commandes, variables et filtres pour aider à l'exécution des commandes et la modifier. Utilisées pour analyser des données, importer des données et produire des résultats.
Ne peut pas constituer une étape indépendante dans un script. Peut être une étape indépendante dans un script.