Variables
Une variable est une valeur enregistrée sous un nom. Une étape l'enregistre ; les étapes suivantes
l'utilisent en écrivant $ et le nom dans un champ, ou en la choisissant sous Enregistré par les
étapes précédentes dans le menu des valeurs (Paramètres des étapes).
Enregistrer le résultat d'une étape
Remplissez Enregistrer le résultat sous sur une étape pour conserver ce qu'elle renvoie. C'est la façon habituelle d'obtenir une valeur : la fenêtre qu'une étape a trouvée, le texte qu'elle a lu, la réponse que quelqu'un a choisie.
La première étape lit le Presse-papiers et enregistre le texte sous copied. La seconde l'affiche dans
une boîte de message.
Définir une variable
La puce Définir une variable ajoute une étape qui stocke une valeur que vous tapez. Elle a trois champs :
| Champ | Contenu |
|---|---|
| Variable | Le nom. Une nouvelle étape reçoit un nom libre comme value ou value2. |
| Valeur | La valeur, $ et le nom d'une autre variable pour copier celle-ci, ou une lecture du menu des valeurs (Paramètres des étapes), comme Texte du Presse-papiers. |
| Type | Texte, Nombre entier, Nombre ou Vrai ou faux. Masqué tant que Valeur contient une lecture. |
Le type est celui que vous choisissez, pas celui auquel la valeur ressemble : avec Texte, 42 est le
texte « 42 », pas le nombre 42. Un texte peut être vide ; les autres types nécessitent une valeur, vérifiée
comme pour tout champ (Paramètres des étapes).
Une lecture stocke ce qu'elle lit à l'exécution de l'étape, avec le type propre à cette lecture : il n'y a
donc pas de Type à choisir. Taper le nom de script de la lecture avec des parenthèses vides, comme
ClipboardGetText(), revient à la choisir, quel que soit le type. Une valeur Texte qui est un appel
de fonction intégrée avec quelque chose entre ses parenthèses, comme WindowGetTitle($w), est stockée
sous forme de ces caractères et n'est pas exécutée ; le formulaire l'indique. Pour conserver le résultat
d'un tel appel, utilisez plutôt Enregistrer le résultat sous sur l'étape de cette fonction.
Définir une variable qui existe déjà remplace sa valeur.
Les types de valeurs
Chaque valeur a l'un de ces types. Les termes de l'éditeur, et ceux de la référence des scripts :
| Dans l'éditeur | Dans la référence des scripts | Exemples |
|---|---|---|
| Texte | Text | Bloc-notes, un texte vide |
| Nombre entier | Integer | 0, -12, 0xB3, VirtualKey.F5 |
| Nombre | Real | 0.5, 2.0 |
| Vrai ou faux | Bool | activé / désactivé, true / false |
| une fenêtre | Window | Fenêtre cible, une fenêtre qu'une étape a trouvée |
Une fenêtre ne peut pas être tapée ; elle provient du menu des valeurs ou du résultat d'une étape. La façon dont chaque type compte comme vrai ou faux dans une condition est décrite dans Types de valeurs.
Noms
Un nom de variable :
- utilise des lettres, des chiffres et
_, et ne commence pas par un chiffre ; - n'est pas
if,else,for,trueoufalse; - est sensible à la casse :
Windowetwindowsont deux variables.
Un $ tapé au début d'un nom est supprimé : $count et count désignent donc la même variable.
Règles à connaître
- L'ordre compte. Une variable existe à partir de l'étape qui l'enregistre. L'éditeur ne vérifie pas qu'une variable est enregistrée avant d'être utilisée, ni que l'étape qui l'enregistre reste au-dessus après un déplacement d'étapes. Une variable jamais enregistrée se lit comme le nombre entier 0.
- Les variables durent une exécution. Chaque fois que l'action s'exécute, elle commence sans variable. Pour conserver une valeur d'une exécution et d'un redémarrage à l'autre, utilisez les étapes Conserver une valeur entre les redémarrages et Lire une valeur conservée (depuis Les N fonctions intégrées… ; voir Exécution des scripts).
- Un extrait a ses propres variables. Un extrait appelé depuis une action ne voit pas les variables de l'action, et l'action ne voit pas celles de l'extrait.
- Il n'y a pas d'arithmétique. Un champ accepte une valeur ou une variable, jamais un calcul comme
$count + 1. Pour cela, utilisez Script (Des étapes au script).