Instructions

Les instructions définissent les actions qu'un script exécute lors de son exécution. Cela comprend la création de variables, l'assignation de nouvelles valeurs, l'exécution de calculs et la prise de choix logiques en fonction d'une Condition donnée. Certaines instructions ne font qu'exécuter une tâche, comme assigner une valeur à une variable. D'autres instructions influent sur le flux du script. Les instructions sont exécutées dans un ordre logique, mais cet ordre peut changer chaque fois que le script s'exécute.

Les instructions dans les extraits de code se composent d’une ou plusieurs lignes de code. Une instruction simple d’une seule ligne peut créer une variable et lui assigner une valeur, comme ceci :

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 des déclarations de déclaration pour déclarer, ou créer, de nouvelles variables, de nouveaux objets et de nouvelles fonctions.
• Prise de décision : Utilisez des déclarations de prise de décision pour permettre au code de l'extrait de sélectionner une tâche à exécuter selon les conditions que vous précisez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
• Boucle : Utilisez des déclarations de boucle pour permettre à l'extrait d'exécuter une tâche ou un ensemble de tâches de façon répétée jusqu'à ce que la condition de fin précisée soit remplie.
• Autre : Ces déclarations vous permettent de terminer des fonctions, d'afficher les résultats dans la fenêtre Snippet editor pendant le débogage, et d'inclure des DLL de proxy de service Web dans vos Extraits.

Mots-clés

Les mots-clés sont des commandes qui commencent les instructions. Ce sont des 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 a un mot-clé qui lui est associé. Par exemple, pour déclarer une variable, vous pouvez utiliser le mot-clé ASSIGN. Ou, pour créer une instruction de sélection, vous pouvez utiliser le mot-clé IF. L’instruction et le mot-clé partagent 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’eux. Une liste complète des Mots-clés est également disponible.

Syntaxe des instructions

Toutes les instructions commencent par un mot-clé et sont suivies de mots ou de code 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 établit une condition et définit ce qui se passe si la condition est remplie ou non. Le code conditionnel peut être une seule 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é un bloc.

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

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, placez-les sur des lignes distinctes. Cela facilite la lecture du code.
• Les instructions intégrées qui nécessitent leur propre code intégré peuvent occuper plusieurs lignes, en suivant 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 possède un résumé de la syntaxe. Le résumé vous montre le format utilisé par ce type d’instruction. Il vous montre quels éléments sont obligatoires et lesquels sont 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. Les instructions n’incluent pas toutes les instructions 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 équivaut à foreach pour le compilateur. Toutefois, l’action Extrait 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 crochets pointus indiquent un élément obligatoire. Le texte à l’intérieur des crochets indique le type d’élément, comme une expression, une variable ou une valeur littérale. Par exemple, dans un résumé de la syntaxe d’une instruction FOREACH, il y a deux éléments obligatoires : FOREACH <var> in <array> { ... [ BREAK]} Les crochets pointus et le texte qu’ils contiennent ne doivent jamais être utilisés littéralement dans votre script. Remplacez cette portion 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 à l’intérieur des crochets indique le type d’élément que vous pouvez utiliser. Par exemple, dans le résumé de la syntaxe IF, la clause facultative ELSE 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.
{ ... }	Curly braces indicate a code block can be used. Les accolades sont différentes des crochets pointus et des crochets utilisés dans le résumé de la syntaxe. Les crochets pointus et les crochets ne doivent pas être inclus dans votre code, mais les accolades doivent être incluses littéralement dans votre code. Toutefois, vous devez remplacer les points de suspension ( ... ) figurant entre les accolades dans le résumé de la syntaxe par des instructions Extrait.
Barre verticale ( | )	Le caractère barre verticale indique que vous avez le choix de ce qu’il faut inclure dans l’instruction. Par exemple, dans le résumé de la syntaxe de l’instruction ASSIGN, le caractère barre verticale indique que vous avez le choix d’entourer la valeur de guillemets doubles : 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é. Un exemple de points de suspension utilisés pour indiquer un modèle continu se trouve dans le résumé de la syntaxe SELECT : SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }> Le[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 :

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 pour les 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.