Hinweise zu den benutzerdefinierten Funktionen

Es wurden einige Dateien aufgenommen, die jeweils maßgebende Funktionen enthalten, sogenannte Defined Functions.
UDF's sind Funktionen/Scriptlets, die in AutoIt3 geschrieben sind und mit #include in eigene Skripte eingebunden und benutzt werden können, ohne dass sie selbst geschrieben oder jedes mal kopiert und eingefügt werden müssen, wenn sie gebraucht werden.
User Defined Functions ist englisch und bedeutet benutzerdefinierte Funktionen

Example

@@SyntaxHighlighting@@ #include #include MsgBox($MB_SYSTEMMODAL,"Das heutige Datum lautet " & _Now()) @@End@@

Dieses Skript zeigt das aktuelle Datum im Datumsformat ihres PC an, z.B. "03.05.2007 17:23:45"

Viele UDF's besitzen optionale Parameter, die weggelassen werden können. Falls sie einen optionalen Parameter angeben wollen, müssen jedoch alle vorhergehenden Parameter mit angegeben werden.
Schauen sie sich als Beipiel dazu folgende Funktion an: _ArraySort ( ByRef $a_Array [, $i_Descending [, $i_Base=0 [, $i_Ubound=0 [, $i_Dim=1 [, $i_SortIndex=0 ]]]]] )
Wenn einem Parameter ByRef vorausgeht, bedeutet dies, dass die Funktion die übergebene Variable mit einem neuen Wert aktualisieren wird. Diese Parameter müssen eine Variable ($xyz) sein und dürfen also keine Konstante sein!

Die meisten UDF's geben Erfolg/Fehler als Rückgabewert an; andere Funktionen setzen dafür das @error Flag. Manche tun auch beides....
@error = 0 ;bedeutet immer Erfolg
Return = variiert, ist aber normalerweise nicht-Null für Erfolg, um einfach zu lesenden Code zu ermöglichen...

Falls eine Funktion das @error-Flag setzt, sollte es immer vor dem Rückgabewert geprüft werden! Falls @error einen Fehler anzeigt, ist der Rückgabewert im allgemeinen undefiniert...