Return

Kehrt aus einer Funktion oder Subroutine zurück, zu der die Ausführung zuvor via Funktionsaufruf, Gosub, Hotkey-Aktivierung, GroupActivate o.ä. gesprungen ist.

Return , Ausdruck

Parameter

Ausdruck

Dieser Parameter kann nur innerhalb einer Funktion verwendet werden.

Wenn weggelassen, wird standardmäßig eine leere Zeichenkette verwendet.

Da dieser Parameter ein Ausdruck ist, sind alle folgenden Zeilen gültig:

return 3
return "direkt geschriebene Zeichenkette"
return MeineVar 
return i + 1
return true  ; Gibt die Zahl 1 als "wahr" zurück.
return ElementeAnzahl < MaxElemente  ; Gibt einen wahren oder falschen Wert zurück.
return FindeFarbe(ZielFarbe)

Bekannte Einschränkung: Aus Gründen der Abwärtskompatibilität und Benutzerfreundlichkeit sind die beiden folgenden Zeilen funktionsgleich:

return MeineVar
return %MeineVar%

Mit anderen Worten, eine einzelne Variable, die von Prozentzeichen umschlossen ist, wird als Nichtausdruck behandelt. Um das zu umgehen, machen Sie es eindeutig zu einem Ausdruck, indem Sie es mit runden Klammern umschließen, z.B. return (%MeineVar%).

Bemerkungen

Wenn es keinen Aufrufer gibt, zu dem zurückgekehrt werden kann, wird Return stattdessen ein Exit ausführen.

Es gibt verschiedene Möglichkeiten, wie eine Funktion mehrere Werte an ihren Aufrufer zurückgeben kann. Informationen dazu finden Sie unter Werte an den Aufrufer zurückgeben.

Funktionen, Gosub, Exit, ExitApp, GroupActivate

Beispiele

Das erste Return trennt den Hotkey von der Subroutine darunter. Wäre es nicht vorhanden, würde das Drücken des Hotkeys dazu führen, dass Sleep 1000 zweimal ausgeführt wird.

#z::
MsgBox Der Hotkey WIN+Z wurde gedrückt.
Gosub MeineSubroutine
return

MeineSubroutine:
Sleep 1000
return

Meldet den Rückgabewert der Funktion.

MsgBox % returnTest() ; Zeigt 123

returnTest() {
    return 123
}