Notes sur les Fonctions

Beaucoup de fonctions contiennent des paramètres optionnels qui peuvent être omis.  Si vous souhaitez spécifier un paramètre, vous devrez impérativement spécifier tous les paramètres précédent !
Par exemple, prenons :

Run ( "filename", ["workingdir" [, flag]] )

Si vous voulez spécifier flag, vous devez specifier workingdir.

Beaucoup de fonctions GUI contiennent un paramètre optionnel "text".  Ce paramètre est sensé vous aider à différencier les fenêtres qui ont un titre identique.


Quelques fonctions indiquent une valeur de retour succès/échec; d'autres l'indiquent par le flag @error.  Et d'autres utilisent les deux ...

@error = 0 ; Signifie toujours un succès
La variable de retour Return varie, mais est généralement différente de zéro pour un succès (Permettant une lecture plus facile du code).

    If someUserFunc() then  ; ... Fonction de succés
    If Not someUserFunc() then  ; ... Fonction d'échec

    $x = FileReadLine("C:\someFile.txt")
    If @error = -1 Then ; La fin du fichier est atteinte.

Si une fonction utilise @error, vous devriez toujours la tester en premier, avant d'utiliser la valeur de retour - Si @error indique une erreur, alors la valeur de retour est généralement indéfinie ...

@error est toujours mis à 0 au départ d'une fonction.

Si la documentation d'une fonction indique qu'il n'y a pas de valeur de retour, AutoIt retourne quand même une valeur pour éviter les erreurs. La valeur retournée est généralement 1, mais ne vous fier pas à cette valeur.