Instructions

Les instructions définissent les actions d’un script lors de son exécution. Il s’agit notamment de créer des variables, d’attribuer de nouvelles valeurs, d’effectuer des calculs et de faire des choix logiques en fonction d’une condition donnée. Certaines instructions n’effectuent qu’une tâche, telle que l’attribution d’une valeur à une variable. D’autres instructions affectent le déroulement du script. Les instructions sont exécutées dans un ordre logique, mais cet ordre peut être modifié à chaque exécution du script.

Les instructions dans les extraits de code consistent en une ou plusieurs lignes de code. Une simple instruction d’une ligne peut créer une variable et lui attribuer une valeur, comme par exemple :

ASSIGN firstName = "Beowulf"

Une instruction complexe peut comporter plusieurs groupes de lignes imbriquées, comme par exemple :

ASSIGN Names="Odin|Freya|Thor|Loki" ASSIGN SubCounter=1 FOREACH Name IN Names { IF Name = "Odin" | Name = "Freya" { ASSIGN NewNames[SubCounter]= "{Name}" ASSIGN SubCounter=SubCounter + 1 } }

Types d’instructions

Vous pouvez utiliser les types d’instructions suivants dans les extraits :

• Déclaration : Utilisez les instructions de déclaration pour déclarer ou créer de nouvelles variables, de nouveaux objets et de nouvelles fonctions.
• Prise de décision : Utilisez les instructions de prise de décision pour que le code de l’extrait sélectionne une tâche à effectuer en fonction des conditions que vous spécifiez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
• Boucle : Utilisez les instructions de boucle pour que l’extrait de code exécute une tâche ou un ensemble de tâches de manière répétée jusqu’à ce que la condition de fin spécifiée soit remplie.
• Autres : Ces instructions vous permettent de mettre fin à des fonctions, d’afficher les résultats dans la fenêtre Snippet editor pendant le débogage et d’inclure des DLL mandataires de services Web dans vos extraits.

Mots-clés

Les mots-clés sont des commandes qui commencent les instructions. Il s’agit de termes prédéfinis et réservés. Le compilateur reconnaît le mot-clé et exécute la tâche qui lui est associée.

Chaque type d’instruction que vous pouvez utiliser dans un extrait est associé à un mot-clé. Par exemple, pour déclarer une variable, vous pouvez utiliser le mot-clé ASSIGN. Ou, pour une instruction de sélection, vous pouvez utiliser le mot-clé IF. L’instruction et le mot-clé portent le même nom, de sorte qu’une instruction IF utilise le mot-clé IF.

Les mots-clés disponibles dans le langage Snippet sont décrits avec l’instruction associée à chacun d’entre eux. Une liste complète de mots-clés est également disponible.

Syntaxe des instructions

Toutes les instructions commencent par un mot-clé et sont suivies de mots ou de codes qui définissent ce que fait l’instruction. Chaque instruction a sa propre syntaxe. La section « Résumé de la syntaxe » de cette page explique comment lire la syntaxe des instructions.

Certaines instructions nécessitent un code conditionnel. Il s’agit d’un code qui fixe une condition et définit ce qui se passe si la condition est ou n’est pas remplie. Le code conditionnel peut être une simple instruction ou plusieurs instructions. Il doit toujours être placé entre accolades ({ }), même s’il s’agit d’une seule ligne. Le code conditionnel est parfois appelé bloc.

Lorsque le compilateur rencontre une nouvelle ligne ou une accolade ouverte, il reconnaît la fin d’une instruction. L’emplacement des accolades est relativement flexible. Les formats suivants sont tous valables :

IF x=1 {TRACE "one" } 

IF x=1 {TRACE "one" } IF x=2 {TRACE "two" }

IF x=1 {
  TRACE "one"
}

IF x=1
{
  TRACE "one"
}

Lorsque le code intégré nécessite plus d’une instruction, suivez les règles suivantes :

• Placez une instruction par ligne.
• Si plusieurs instructions sont nécessaires, elles doivent être placées sur des lignes séparées. Cela facilite la lecture du code.
• Les instructions intégrées qui nécessitent leur propre code intégré peuvent occuper plusieurs lignes, en respectant les formats valides pour l’utilisation des accolades.

Résumés de la syntaxe

Dans les pages d’aide en ligne qui couvrent chaque type d’instruction, chaque type d’instruction est accompagné d’un résumé de la syntaxe. Le résumé vous indique le format utilisé pour ce type d’instruction. Il vous indique les éléments requis et les éléments facultatifs. Il montre également comment les éléments syntaxiques doivent être imbriqués.

Le tableau suivant définit chaque élément des résumés de la syntaxe. Toutes les instructions n’incluent pas tous les éléments. Lorsque vous déchiffrez un résumé de la syntaxe, prêtez attention à l’imbrication des éléments.

Élément	Détails
COMMAND	Il s’agit du nom du mot-clé à utiliser avec l’instruction. Remplacez COMMAND par le mot-clé de l’instruction que vous créez. Les mots-clés ne sont pas sensibles à la casse. Par exemple, FOREACH est identique à foreach pour le compilateur. Cependant, l’action Snippet convertit automatiquement tous les mots-clés en majuscules la prochaine fois que vous ouvrez l’extrait. Dans l’aide en ligne, les mots-clés sont toujours présentés en majuscules.
<required>	Les chevrons indiquent un élément obligatoire. Le texte entre les crochets indique le type d’élément, tel qu’une expression, une variable ou une valeur littérale. Par exemple, dans le résumé de la syntaxe d’une instruction FOREACH, il y a deux éléments requis : FOREACH <var> in <array> { ... [ BREAK]} Les crochets et le texte qu’ils contiennent ne doivent jamais être utilisés littéralement dans votre script. Remplacez cette partie par l’élément de code qu’elle décrit. Par exemple, remplacez <expression> par une expression telle que i = 0.
[optional]	Les crochets indiquent un élément facultatif. Le texte entre crochets indique le type d’élément que vous pouvez utiliser. Par exemple, dans le résumé de la syntaxe IF, la clause ELSE optionnelle est placée entre crochets : [ELSE { ... }. Si vous utilisez un élément optionnel, il doit apparaître à l’emplacement indiqué dans le résumé de la syntaxe par rapport aux autres éléments. Les crochets ne doivent jamais être utilisés littéralement dans votre script.
{ ... }	Les accolades indiquent qu’un bloc de code peut être utilisé. Les accolades sont différentes des chevrons et des crochets utilisés dans le résumé de la syntaxe. Les chevrons et les crochets ne sont pas censés être inclus dans votre code, mais les accolades doivent être incluses littéralement dans votre code. Cependant, vous devez remplacer les points de suspension (...) à l’intérieur des accolades dans le résumé de la syntaxe par des instructions Snippet.
Barre verticale ( | )	La barre verticale indique que vous avez le choix des éléments à inclure dans l’instruction. Par exemple, dans le résumé de la syntaxe de l’instruction ASSIGN, la barre verticale indique que vous avez le choix de mettre la valeur entre guillemets : ASSIGN <variable> = "<value>" | <value> L’explication de la syntaxe explique le choix.
Points de suspension (...)	Les points de suspension indiquent l’une ou l’autre chose : L’emplacement du code dans un bloc, s’il se trouve entre accolades. Un modèle continu, s’il est trouvé entre crochets avec un mot-clé. Le résumé de la syntaxe SELECT donne un exemple d’utilisation des points de suspension pour indiquer un modèle continu : SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }> [CASE ...] indique que vous pouvez continuer à ajouter autant de clauses CASE que nécessaire en suivant le modèle établi.

Par exemple, le résumé de la syntaxe des instructions IF utilisées sur cette page est le suivant :

IF <expression> <{ ... }>

Ce résumé montre que :

• Le mot clé est IF.
• L’élément suivant est une expression obligatoire.
• Le dernier élément est un bloc de code obligatoire qui doit être placé entre accolades.

Le résumé de la syntaxe des instructions SWITCH est plus complexe :

SWITCH <var> <{CASE <literal> [{ ... }] [CASE <literal> [{ ... }]] [CASE ...] [DEFAULT [{ ... }]] }>

Ce résumé montre que :

• Le mot clé est SWITCH.
• L’élément suivant est un nom de variable obligatoire.
• Le bloc de code est obligatoire et doit contenir une clause CASE avec une valeur littérale.
• La clause CASE obligatoire peut contenir un bloc de code facultatif.
• Le bloc de code de l’instruction SWITCH peut inclure des clauses CASE facultatives supplémentaires suivant le modèle établi dans le résumé.
• Le bloc de code de l’instruction SWITCH peut contenir une clause DEFAULT facultative avec un bloc de code facultatif.