Déclarations

Les instructions définissent les actions qu'un script exécute 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 effectuent uniquement une tâche, comme l'affectation 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 changer à chaque exécution du script.

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

ASSIGN firstName = "Beowulf"

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

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 snippets :

• Déclaration : utilisez les instructions déclaration pour déclarer, ou créer, de nouvelles variables, de nouveaux objets et de nouvelles fonctions.
• Prise de décision : utilisez prise de décision instructions permettent au code de l'extrait de sélectionner une tâche à exécuter en fonction des conditions que vous précisez. Vous pouvez les utiliser pour contrôler le flux linéaire de ce qui se passe dans le script.
• Bouclage : utilisez des déclarations de bouclage pour que l'extrait 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.
• Autre : ces instructions 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. 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 snippet est associé à un mot-clé. Par exemple, pour déclarer une variable, vous pouvez utiliser le mot-clé ASSIGN. Pour effectuer une sélection, vous pouvez également 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 la langue Extrait sont décrits avec l'instruction associée à chacun d'eux. Une liste complète des mots-clés est également disponible.

Syntaxe de l'instruction

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 les syntaxes des instructions.

Certaines déclarations nécessitent un code conditionnel. Il s'agit de 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 instruction unique ou plusieurs instructions. Elle doit toujours être placée 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 ouvrante, il reconnaît la fin d'une instruction. Le placement 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 que une instruction, respectez les règles suivantes :

• Placez une instruction par ligne.
• Si plusieurs instructions sont requises, placez-les 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 suivant les formats valides d'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 montre le format qu'utilise ce type d'instruction. Il explique quels sont les éléments requis et ceux qui sont facultatifs. Il montre également comment les éléments de syntaxe doivent être imbriqués.

La table suivante définit chaque élément des résumés de syntaxe. Tous les énoncés n'incluent pas chaque élément. Lorsque vous déchiffrez un résumé de syntaxe, prêtez attention à l'imbrication des éléments.

Élément	Détails
COMMAND	Le nom du mot-clé à utiliser avec l’instruction. Remplacez COMMAND par le mot-clé correspondant à l'instruction que vous créez. Les mots-clés ne sont pas sensibles à la casse. Par exemple : POUR CHAQUE est identique à pour chaque pour le compilateur. Cependant, 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 lettres majuscules.
<required>	Les chevrons indiquent un élément obligatoire. L'intérieur du texte entre crochets indique le type d'élément, tel qu'une expression, une Variable ou une valeur littérale. Par exemple, dans un résumé de syntaxe de l'instruction FOREACH, il existe deux éléments requis : FOREACH <var> in <array> { ... [ BREAK]} Les chevrons et le texte qu'ils contiennent ne doivent jamais être utilisés littéralement dans votre script. Remplacer 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 syntaxe IF, la clause ELSE en option est placée entre crochets : [ELSE { ... }. Si vous utilisez un élément facultatif, il doit apparaître à l'endroit 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 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 ( ... ) entre les accolades dans le résumé de la syntaxe par des instructions Extrait.
Trait vertical ( | )	Le caractère de barre verticale indique l'endroit où vous avez le choix de ce qu'il faut inclure dans l'instruction. Par exemple, dans le résumé de syntaxe de l'instruction ASSIGN, le caractère de barre verticale indique que vous avez le choix d'inclure la valeur entre guillemets doubles : ASSIGN <variable> = "<value>" | <value> L'explication de la syntaxe explique le choix.
Points de suspension (...)	Les points de suspension ont deux significations possibles : L'emplacement du code dans un bloc, s'il se trouve entre accolades. Un motif continu, s'il est trouvé entre crochets avec un mot-clé. Un exemple d'utilisation d'une ellipse pour indiquer un motif qui se poursuit se trouve dans le résumé de la syntaxe SELECT : SELECT <{ CASE <expression> [{ ... }] [CASE <expression> <{ ... }>] [CASE ...] [DEFAULT <{ ... }>] }> Le symbole [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 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 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 en option.
• Le bloc de code de l'instruction SWITCH peut inclure des clauses CASE supplémentaires en option, suivant le modèle établi dans le résumé.
• Le bloc de code de l'instruction SWITCH peut contenir une clause DEFAULT en option avec un bloc de code en option.