Notes sur les UDF

Nous avons inclus de nombreux fichiers qui contiennent chacun des Fonctions standards de AutoIt3, aussi appelées User Defined Functions (Fonctions Définies par l'Utilisateur).
Les fonctions UDF sont des fonctions/Scriptlets, écrites avec AutoIt3, vous pouvez les inclure (#include) dans vos propres scripts et les utiliser sans avoir besoin de les écrire vous-même ou de les copier/coller chaque fois que vous en avez besoin.

Exemple:

#include <MsgBoxConstants.au3>
#include <Date.au3>

MsgBox($MB_SYSTEMMODAL, "Quelle est la date?", "Aujourd'hui on est le " & _Now())

Ce script affiche la date du jour dans le format de votre PC. Exemple: 19/10/2014 06:52:19


Beaucoup d'UDF 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édents !
Par exemple, prenons :_ArraySort ( ByRef $a_Array [, $i_Descending [, $i_Base=0 [, $i_Ubound=0 [, $i_Dim=1 [, $i_SortIndex=0 ]]]]] )
Lorsqu'un paramètre est précédé par Byref cela signifie que la fonction doit mettre à jour la variable avec une nouvelle valeur. Ces paramètres doivent être une variable ($xyz) et ne peuvent être une constante.

La majorité des UDF indiquent un succès ou un échec comme valeur de retour; d'autres l'indiquent en utilisant le flag @error. Et d'autres utilisent les deux ...
@error = 0 ; Signifie toujours un succès
Return = typiquement non nul pour un succès (Permettant une lecture plus facile du code).

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