Variablen und Ausdrücke

Dereferenzierung oder Namensubstitution.

Wenn die Auswertung von Ausdr eine VarRef ergibt, greift %Ausdr% auf die entsprechende Variable zu. Zum Beispiel nimmt x := &y eine Referenz, die auf y verweist, und weist sie x zu, dann weist %x% := 1 der Variable y etwas zu und %x% liest ihren Wert.

Andernfalls wird der Wert des Teilausdrucks Ausdr als Name oder Teilname einer Variable oder Eigenschaft verwendet. Auf diese Weise kann das Skript auf eine Variable oder Eigenschaft verweisen, deren Name durch die Auswertung von Ausdr ermittelt wird, was typischerweise eine andere Variable ist. Variablen können nicht dynamisch erstellt werden, aber eine Variable kann dynamisch zugewiesen werden, wenn sie irgendwo im Skript nicht-dynamisch deklariert oder referenziert wurde.

Hinweis: Das Ergebnis des Teilausdrucks Ausdr muss der Name oder Teilname der Variable oder Eigenschaft sein, auf die zugegriffen werden soll.

Prozentzeichen dürfen wegen ihrer Mehrdeutigkeit nicht direkt in Ausdr verwendet werden, können aber innerhalb von runden Klammern verschachtelt werden. Andernfalls kann Ausdr ein beliebiger Ausdruck sein.

Eventuell angrenzende %Ausdr%-Sequenzen und teilweise vorhandene Namen (ohne Leerzeichen oder andere Zeichen dazwischen) werden zu einem einzigen Namen kombiniert.

Standardmäßig wird ein Error ausgelöst, wenn die Variable noch nicht existiert oder wenn sie uninitialisiert ist und ihr Wert gelesen wird. Um diesen Fall zu vermeiden, kann mit dem Oder-Vielleicht-Operator (??) ein Standardwert bereitgestellt werden. Zum Beispiel: %'keineVar'% ?? 42.

Obwohl historisch als "double-deref" (Doppeldereferenz) bekannt, ist dieser Begriff ungenau, wenn Ausdr keine Variable enthält (erste Dereferenzierung), und wenn die resultierende Variable, die das Ziel einer Zuweisung ist, nicht dereferenziert wird (zweite Dereferenzierung).

Vielleicht. Erlaubt einer Variable, ungesetzt zu sein. Dies kann nur für die Übergabe einer Variable an einen optionalen Parameter, an ein Array-Element oder an ein Objektliteral (direkt geschriebenes Objekt) verwendet werden; oder auf der rechten Seite einer direkten Zuweisung. Nach dem Fragezeichen muss eines der folgenden Symbole stehen (Leerzeichen werden ignoriert): )]},:. Die Variable kann bedingt mit dem ternären Operator oder auf der rechten Seite von AND/OR übergeben werden.

Die Variable ist typischerweise ein optionaler Parameter, kann aber eine beliebige Variable sein. Für Variablen, die keine Funktionsparameter sind, kann beim Laden des Skripts immer noch eine VarUnset-Warnung angezeigt werden, wenn andere Referenzen zu der Variable existieren, aber keine Zuweisungen.

Dieser Operator wird derzeit nur für Variablen unterstützt. Um in allgemeineren Fällen einen Parameter explizit oder bedingt wegzulassen, verwenden Sie das Schlüsselwort unset.

Siehe auch: unset (Optionale Parameter)

Vorherige und nachherige Inkrementierung/Dekrementierung. Erhöht oder verringert eine Variable um 1. Der Operator kann entweder vor oder hinter dem Namen der Variable stehen. Wenn der Operator vor dem Namen steht, wird die Operation ausgeführt und das Ergebnis wird von der nächsten Operation verwendet (das Ergebnis ist in diesem Fall eine Variablenreferenz). Zum Beispiel bewirkt Var := ++X, dass X um 1 erhöht und der Wert in Var gespeichert wird. Wenn der Operator hingegen hinter dem Namen einer Variable steht, ist das Ergebnis der Wert von X vor der Ausführung der Operation. Zum Beispiel bewirkt Var := X++, dass X um 1 erhöht wird, aber Var erhält den Wert, den X vor der Inkrementierung hatte.

Diese Operatoren können auch mit einer Eigenschaft eines Objekts verwendet werden, z.B. meinArray.Length++ oder --meinArray[i]. In diesen Fällen ist das Ergebnis des Teilausdrucks immer eine Zahl, keine Variablenreferenz.

Potenz. Anwendungsbeispiel: Basis**Exponent. Sowohl Basis als auch Exponent können einen Dezimalpunkt enthalten. Wenn Exponent negativ ist, wird das Ergebnis in eine Floating-Point-Zahl umgewandelt, auch dann, wenn Basis und Exponent Integer sind. Da dieser Operator eine höhere Priorität als ein unäres Minuszeichen hat, wird -2**2 wie -(2**2) ausgewertet und somit -4 zurückgeben. Um eine direkt geschriebene negative Zahl zu potenzieren, umschließen Sie diese mit runden Klammern, z.B. (-2)**2.

Der Potenzoperator ist rechtsassoziativ. Zum Beispiel wird x ** y ** z als x ** (y ** z) ausgewertet.

Hinweis: Eine negative Basis mit einem gebrochenen Exponenten wie (-2)**0.5 wird nicht unterstützt und führt dazu, dass eine Ausnahme ausgelöst wird. Allerdings werden sowohl (-2)**2 als auch (-2)**2.0 unterstützt. Wenn Basis und Exponent 0 sind, ist das Ergebnis undefiniert und führt dazu, dass eine Ausnahme ausgelöst wird.

Unäres Minuszeichen (-): Invertiert das Vorzeichen des Operanden.

Unäres Pluszeichen (+): +N ist dasselbe wie -(-N). Dieser Operator hat keinen Effekt, wenn er auf eine reine Zahl angewendet wird, ist aber nützlich, um numerische Zeichenketten in reine Zahlen umzuwandeln.

Logisches NICHT (!): Wenn dieser Operator auf einen Operanden angewendet wird, der leer oder 0 ist, ist das Ergebnis 1 (true). Andernfalls ist das Ergebnis 0 (false). Zum Beispiel: !x or !(y and z). Hinweis: Das Wort NOT ist synonym mit !, allerdings hat ! eine höhere Priorität. Aufeinanderfolgende unäre Operatoren wie !!Var sind erlaubt, da sie von rechts nach links ausgewertet werden.

Bitweises NICHT (~): Dieser Operator invertiert jedes Bit seines Operanden. Da vorzeichenfähige 64-Bit-Integer verwendet werden, führt ein positiver Eingabewert immer zu einem negativen Ergebnis und umgekehrt. Zum Beispiel ergibt die Auswertung von ~0xf0f -0xf10 (-3856), was binär äquivalent zu 0xfffffffffffff0f0 ist. Wenn ein vorzeichenloser 32-Bit-Wert beabsichtigt ist, kann das Ergebnis mit Ergebnis & 0xffffffff gekürzt werden. Wenn der Operand eine Floating-Point-Zahl ist, wird ein TypeError ausgelöst.

Referenz (&): Erstellt eine VarRef. Dies ist ein Wert, der eine Referenz repräsentiert, die auf eine Variable verweist. Eine VarRef kann verwendet werden, um indirekt auf die Zielvariable zuzugreifen. Zum Beispiel bewirkt Ref := &Ziel gefolgt von %Ref% := 1, dass 1 in Ziel gespeichert wird. Die VarRef wird normalerweise an eine Funktion übergeben, kann aber auch in ein Array oder eine Eigenschaft gespeichert werden. Siehe auch: Dereferenz, ByRef.

Das Abrufen einer Referenz, die auf eine interne Variable wie z.B. A_Clipboard verweist, wird derzeit nicht unterstützt, es sei denn, sie wird direkt an einen AusgabeVar-Parameter einer internen Funktion übergeben.

Multiplikation (*): Das Ergebnis ist ein Integer, wenn beide Eingabewerte Integer sind, andernfalls ist es eine Floating-Point-Zahl.

Andere Verwendungen: Das Sternchensymbol (*) kann auch in variadischen Funktionsaufrufen verwendet werden.

Echte Division (/): Die echte Division liefert immer eine Floating-Point-Zahl, auch dann, wenn beide Eingabewerte Integer sind. Zum Beispiel ergibt 3/2 1.5 statt 1 und 4/2 2.0 statt 2.

Integer-Division (//): Der Doppelschrägstrich-Operator verwendet eine hochperformante Integer-Division. Zum Beispiel ergibt 5//3 1 und 5//-3 -1. Wenn einer der Eingabewerte im Floating-Point-Format ist, wird ein TypeError ausgelöst. Um stattdessen eine Division mit Rest (Modulo) durchzuführen, siehe Mod.

Die Operatoren *= und /= sind Kurzschreibweisen zum Multiplizieren oder Dividieren eines Variablenwerts mit einem anderen Wert. Zum Beispiel liefert Var *= 2 dasselbe Ergebnis wie Var := Var * 2 (obwohl Ersteres performanter ist).

Eine Division durch 0 bewirkt, dass ein ZeroDivisionError ausgelöst wird.

Addition (+) und Subtraktion (-). Die Operatoren += und -= sind Kurzschreibweisen zum Erhöhen oder Verringern eines Variablenwerts um einen beliebigen Wert. Zum Beispiel liefert Var += 2 dasselbe Ergebnis wie Var := Var + 2 (obwohl Ersteres performanter ist). Ebenso kann eine Variable mit Var++, Var--, ++Var oder --Var schrittweise um 1 erhöht oder verringert werden.

Andere Verwendungen: Wenn dem Plus- oder Minuszeichen kein Wert (oder Teilausdruck, der einen Wert zurückgibt) vorangestellt ist, wird es stattdessen als unärer Operator interpretiert.

Bitweise Verschiebung nach links (<<). Anwendungsbeispiel: Wert1 << Wert2. Entspricht der Multiplikation von Wert1 mit "2 hoch Wert2".

Arithmetische bitweise Verschiebung nach rechts (>>). Anwendungsbeispiel: Wert1 >> Wert2. Entspricht der Division von Wert1 durch "2 hoch Wert2" und der Rundung des Ergebnisses auf den am nächsten links befindlichen Integer. Zum Beispiel ergibt -3>>1 -2.

Logische bitweise Verschiebung nach rechts (>>>). Anwendungsbeispiel: Wert1 >>> Wert2. Im Gegensatz zur arithmetischen bitweisen Verschiebung nach rechts wird bei dieser Verschiebung das Vorzeichen der Zahl nicht beibehalten. Zum Beispiel hat -1 die gleiche Bitdarstellung wie der vorzeichenlose 64-Bit-Integer 0xffffffffffffffffff, daher ist -1 >>> 1 0x7fffffffffffffffff.

Das Folgende gilt für alle drei Operatoren:

• Wenn einer der Eingabewerte eine Floating-Point-Zahl ist, wird ein TypeError ausgelöst.
• Es wird eine 64-Bit-Operation durchgeführt und das Ergebnis ist ein vorzeichenfähiger 64-Bit-Integer.
• Wenn Wert2 kleiner als 0 oder größer als 63 ist, wird eine Ausnahme ausgelöst.

Bitweises UND (&), bitweises exklusives ODER (^) und bitweises ODER (|). Von diesen drei Operatoren hat & die höchste Priorität und | die niedrigste Priorität.

Das Folgende gilt für alle drei Operatoren:

• Wenn einer der Eingabewerte eine Floating-Point-Zahl ist, wird ein TypeError ausgelöst.
• Es wird eine 64-Bit-Operation durchgeführt und das Ergebnis ist ein vorzeichenfähiger 64-Bit-Integer.

Siehe auch: Bitweises NICHT (~)

Verkettung. Ein Punkt mit mindestens einem Leer- oder Tabulatorzeichen auf beiden Seiten wird verwendet, um zwei Elemente zu einer einzelnen Zeichenkette zu kombinieren. Dasselbe kann auch ohne diesen Punkt erzielt werden (außer bei Mehrdeutigkeiten wie x -y oder wenn dem rechts befindlichen Element ein ++ oder -- vorangestellt ist). Wenn der Punkt weggelassen wird, muss zwischen den Elementen mindestens ein Leer- oder Tabulatorzeichen stehen.

Var := "Die Farbe ist " . GefundeneFarbe  ; Explizite Verkettung
Var := "Die Farbe ist " GefundeneFarbe    ; Auto-Verkettung

Teilausdrücke können auch verkettet werden. Zum Beispiel: Var := "Der Nettopreis ist " . Preis * (1 - Rabatt/100).

Eine Zeile, die mit einem Punkt (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden.

Es wird immer die volle Länge jedes Eingabewertes verwendet, auch dann, wenn binäre Nullen enthalten sind. Zum Beispiel erzeugt Chr(0x2010) Chr(0x0000) Chr(0x4030) die folgende Zeichenkette von Bytes (wegen der UTF-16-LE-Kodierung): 0x10, 0x20, 0, 0, 0x30, 0x40. Das Ergebnis hat einen zusätzlichen Nullterminator (binäre Null), der nicht zur Länge hinzugezählt wird.

Andere Verwendungen: Wenn kein Leer- oder Tabulatorzeichen rechts vom Punkt steht, wird dies entweder als direkt geschriebene Floating-Point-Zahl oder als Objektelementzugriff interpretiert. Zum Beispiel ist 1.1 oder (.5) eine Zahl, A_Args.Has(3) ein Methodenaufruf und A_Args.Length ein Eigenschaftszugriff.

Größer (>), kleiner (<), größer gleich (>=) und kleiner gleich (<=). Die Eingabewerte werden numerisch verglichen. Es wird ein TypeError ausgelöst, wenn einer der Eingabewerte weder eine Zahl noch eine numerische Zeichenkette ist.

nicht-Groß-/Kleinschreibung-sensitiv gleich (=) / ungleich (!=) und Groß-/Kleinschreibung-sensitiv gleich (==) / ungleich (!==). Die Operatoren == und = verhalten sich gleich, wenn beide Eingabewerte numerisch sind, es sei denn, einer der Eingabewerte ist nicht numerisch (oder beide sind Zeichenketten), dann ist == immer Groß-/Kleinschreibung-sensitiv und = immer nicht-Groß-/Kleinschreibung-sensitiv. Die Operatoren != und !== verhalten sich wie ihre Gegenstücke ohne !, außer dass das Ergebnis invertiert ist.

Mit den Operatoren == und !== können Zeichenketten verglichen werden, die binäre Nullen enthalten. Alle anderen Vergleichsoperatoren außer ~= vergleichen Zeichenketten nur bis zur ersten binären Null.

Bei nicht-Groß-/Kleinschreibung-sensitiven Vergleichen werden nur die ASCII-Großbuchstaben A bis Z und die entsprechenden Kleinbuchstaben als identisch betrachtet. Um stattdessen gemäß den Regeln der aktuellen Sprach- und Regionseinstellungen des Benutzers zu vergleichen, verwenden Sie StrCompare und geben Sie "Locale" im GroßKleinSensitiv-Parameter an.

Wert is Klasse ist 1 (true), wenn Wert eine Instanz von Klasse ist, andernfalls 0 (false). Klasse muss ein Object mit einer eigenen Prototype-Eigenschaft sein, aber in der Regel ist die Eigenschaft implizit durch eine Klassendefinition definiert. Diese Operation ist grundsätzlich äquivalent zu HasBase(Wert, Klasse.Prototype).

in und contains sind für zukünftige Zwecke reserviert.

Beide Operatoren sind ein logisches UND. Zum Beispiel: x > 3 and x < 10.

In einem Ausdruck, wo alle Operanden wahr sind, wird der letzte Operand zurückgegeben. Andernfalls wird der erste Operand, der falsch ist, zurückgegeben. Mit anderen Worten, das Ergebnis ist nur wahr, wenn alle Operanden wahr sind. Boolesche Ausdrücke werden einer Kurzschlussauswertung unterzogen (von links nach rechts), um die Performanz zu verbessern.

Im folgenden Beispiel sind alle Operanden wahr und werden ausgewertet:

A := 1, B := {}, C := 20, D := true, E := "Zkette"
MsgBox(A && B && C && D && E) ; Zeigt "Zkette" (E).

Im folgenden Beispiel werden nur die ersten beiden Operanden ausgewertet, da B falsch ist. Der Rest wird ignoriert, d.h. auch C wird nicht inkrementiert:

A := 1, B := "", C := 0, D := false, E := "Zkette"
MsgBox(A && B && ++C && D && E) ; Zeigt "" (B).

Eine Zeile, die mit AND oder && (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden.

Beide Operatoren sind ein logisches ODER. Zum Beispiel: x <= 3 or x >= 10.

In einem Ausdruck, wo mindestens ein Operand wahr ist, wird der erste Operand, der wahr ist, zurückgegeben. Andernfalls wird der letzte Operand, der falsch ist, zurückgegeben. Mit anderen Worten, wenn mindestens ein Operand wahr ist, ist auch das Ergebnis wahr. Boolesche Ausdrücke werden einer Kurzschlussauswertung unterzogen (von links nach rechts), um die Performanz zu verbessern.

Im folgenden Beispiel ist mindestens ein Operand wahr. Alle Operanden bis zu D werden ausgewertet. E wird ignoriert und nie inkrementiert:

A := "", B := false, C := 0, D := "Zkette", E := 20
MsgBox(A || B || C || D || ++E) ; Zeigt "Zkette" (D).

Im folgenden Beispiel sind alle Operanden falsch und werden ausgewertet:

A := "", B := false, C := 0
MsgBox(A || B || C) ; Zeigt "0" (C).

Eine Zeile, die mit OR oder || (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden.

Oder-Vielleicht, auch Koaleszenzoperator genannt. Wenn der linke Operand (der eine Variable sein muss) einen Wert hat, wird dieser als Ergebnis verwendet und der rechte Zweig übersprungen. Andernfalls wird der rechte Operand als Ergebnis verwendet. Mit anderen Worten, A ?? B verhält sich wie A || B (logisches OR), außer dass die Bedingung IsSet(A) ist.

Dieser Operator wird typischerweise verwendet, um einen Standardwert anzugeben, wenn bekannt ist, dass eine Variable oder ein optionaler Parameter noch keinen Wert haben wird. Zum Beispiel:

MsgBox MeineVar ?? "Standardwert"

Da die Variable in diesem Fall uninitialisiert sein kann, wird kein Fehler ausgelöst. Im Gegensatz zu IsSet(A) ? A : B kann beim Laden des Skripts immer noch eine VarUnset-Warnung angezeigt werden, wenn andere Referenzen zu der Variable existieren, aber keine Zuweisungen.

Ternärer Operator. Dieser Operator ist die Kurzschreibweise für eine if-else-Anweisung. Er wertet die Bedingung auf seiner linken Seite aus, um zu bestimmen, welche seiner beiden Verzweigungen als Endergebnis dienen soll. Zum Beispiel bewirkt Var := x>y ? 2 : 3, dass 2 in Var gespeichert wird, wenn x größer als y ist, andernfalls wird 3 gespeichert. Zur Verbesserung der Performanz wird nur die gewinnende Verzweigung ausgewertet (siehe Kurzschlussauswertung).

Siehe auch: Vielleicht (Var?), Oder-Vielleicht (??)

Hinweis: Wenn dieser Operator am Anfang einer Zeile verwendet wird, ist es ratsam, die ternäre Bedingung in runde Klammern zu setzen, um Mehrdeutigkeiten mit anderen Anweisungsarten zu vermeiden. Einzelheiten finden Sie unter Ausdrucksanweisungen.

Zuweisung. Führt eine Operation am Inhalt einer Variable durch und speichert das Ergebnis wieder in dieselbe Variable. Der einfachste Zuweisungsoperator ist Doppelpunkt-Gleich (:=), der das Ergebnis eines Ausdrucks in eine Variable speichert. Eine Beschreibung der anderen Operatoren finden Sie in den entsprechenden Einträgen dieser Tabelle. Zum Beispiel führt Var //= 2 eine Integer-Division durch, um Var durch 2 zu teilen, und speichert das Ergebnis wieder in Var. Ein weiteres Beispiel ist Var .= "abc", was die Kurzschreibweise für Var := Var . "abc" ist.

Im Gegensatz zu den meisten anderen Operatoren werden Zuweisungen von rechts nach links ausgewertet. Folglich bewirkt eine Zeile wie Var1 := Var2 := 0, dass zuerst 0 in Var2 und dann Var2 in Var1 gespeichert wird.

Wenn eine Zuweisung als Eingabe für einen anderen Operator verwendet wird, ist der Eingabewert die Variable selbst. Zum Beispiel ist der Ausdruck (Var += 2) > 50 wahr, wenn der soeben erhöhte Wert in Var größer als 50 ist. Eine Zuweisung kann auch mit dem Referenzoperator kombiniert werden, wie in &(Var := "Startwert").

Die Priorität der Zuweisungsoperatoren wird automatisch erhöht, wenn dadurch ein Syntaxfehler vermieden oder ein intuitiveres Verhalten erreicht wird. Zum Beispiel: not x := y ist äquivalent zu not (x := y). Außerdem wird x==y && z:=1 als x==y && (z:=1) ausgewertet, und kurzgeschlossen, wenn x ungleich y ist. Ebenso wird ++Var := X als ++(Var := X) und Z > 0 ? X := 2 : Y := 2 als Z > 0 ? (X := 2) : (Y := 2) ausgewertet.

Um die Zielvariable ungesetzt zu machen, kombinieren Sie eine direkte Zuweisung (:=) mit dem Schlüsselwort unset oder dem Operator Vielleicht (var?). Zum Beispiel: Var := unset, Var1 := (Var2?).

Eine Zuweisung kann auch mit einer Eigenschaft eines Objekts verwendet werden, z.B. meinArray.Length += n oder meinArray[i] .= t. Bei einer Eigenschaft ist der Zuweisungswert das Ergebnis des Teilausdrucks, keine Variablenreferenz.

Fat-Arrow-Funktion. Definiert eine einfache Funktion und gibt ein Func- oder Closure-Objekt zurück. Schreiben Sie die Parameterliste der Funktion (optional mit vorangestelltem Funktionsnamen) links neben den Operator. Wenn die Funktion aufgerufen wird (über die zurückgegebene Referenz), wertet sie den Teilausdruck Ausdr aus und gibt das Ergebnis zurück.

Die folgenden zwei Beispiele sind äquivalent:

sumfn := Sum(a, b) => a + b

Sum(a, b) {
    return a + b
}
sumfn := Sum

In beiden Fällen wird die Funktion zum Zeitpunkt des Skriptstarts bedingungslos definiert, aber die Funktionsreferenz wird erst nach Auswertung der Zuweisung in sumfn gespeichert.

Wenn der Funktionsname weggelassen wird und die Parameterliste nur aus einem einzigen Parameternamen besteht, können die runden Klammern weggelassen werden. Das folgende Beispiel definiert eine anonyme Funktion mit dem Parameter a und speichert ihre Referenz in die Variable double:

double := a => a * 2

Variablenreferenzen in Ausdr werden auf die gleiche Weise aufgelöst wie in der äquivalenten vollständigen Funktionsdefinition. Zum Beispiel kann Ausdr auf die lokalen Variablen einer äußeren Funktion verweisen (wie in jeder verschachtelten Funktion), woraufhin ein neues Closure erzeugt wird, das jedes Mal seinen Wert zurückgibt, wenn der Fat-Arrow-Ausdruck ausgewertet wird. Die Funktion ist immer eine Assume-Local-Funktion, da Deklarationen nicht verwendet werden können.

Gibt man der Funktion einen Namen, kann sie rekursiv oder von anderen verschachtelten Funktionen aufgerufen werden, ohne dass in der Funktion selbst eine Referenz zum Closure gespeichert werden muss (und dadurch ein problematischer Zirkelbezug entsteht). Dies kann auch fürs Debuggen hilfreich sein, z.B. mit Func.Name oder zum Anzeigen auf dem Aufrufstapel des Debuggers.

Die Fat-Arrow-Syntax kann auch zum Definieren von Shorthand-Eigenschaften und -Methoden verwendet werden.

Komma (Mehrfachanweisung). Kommas können verwendet werden, um mehrere Teilausdrücke auf eine Zeile zu schreiben. Dies wird üblicherweise verwendet, um mehrere Zuweisungen oder Funktionsaufrufe zu gruppieren. Zum Beispiel: x:=1, y+=2, ++index, MeineFunk(). Solche Anweisungen werden von links nach rechts ausgeführt.

Hinweis: Eine Zeile, die mit einem Komma (oder einem anderen Operator) beginnt, wird automatisch mit der darüber liegenden Zeile verbunden.

Das Komma wird auch verwendet, um die Parameter eines Funktionsaufrufs oder einer Kontrollanweisung voneinander zu trennen. Um einen Mehrfachanweisungsausdruck in eine Parameterliste einzufügen, umschließen Sie ihn mit einem zusätzlichen Paar runder Klammern. Zum Beispiel wertet MeineFn((x, y)) sowohl x als auch y aus, übergibt aber y als den ersten und einzigen Parameter von MeineFn.

Ein beliebiger Teilausdruck in runden Klammern. Zum Beispiel bewirkt (3 + 2) * 2, dass 3 + 2 zuerst ausgewertet wird.

Bei einer Mehrfachanweisung wird das Ergebnis der letzten Anweisung zurückgegeben. Zum Beispiel bewirkt (a := 1, b := 2, c := 3), dass 3 zurückgegeben wird.

Funktionsaufruf. Zwischen dem Funktionsnamen/Ausdruck und der runden Startklammer, die die Parameterliste beginnt, dürfen keine Leerzeichen stehen. Einzelheiten finden Sie unter Funktionsaufrufe.

(Ausdruck) muss nicht in Klammern gesetzt werden, aber dadurch können Mehrdeutigkeiten vermieden werden. Zum Beispiel liest (x.y)() eine Funktion aus einer Eigenschaft und ruft sie dann ohne Parameter auf, während x.y() implizit x als ersten Parameter übergeben würde.

Variadischer Funktionsaufruf. Params ist ein enumerierbares Objekt (ein Objekt mit einer __Enum-Methode), z.B. ein Array von Parameterwerten.

Objektelementzugriff. Ermittelt oder setzt die __Item-Eigenschaft (oder Standardeigenschaft) des Objekts x mit dem Parameter y (oder mehreren Parametern anstelle von y). Dies entspricht typischerweise einem Array-Element oder einem Element in einer Collection, wobei y der Index oder Schlüssel des Elements ist. Um dem Element einen Wert zuzuweisen, verwenden Sie einen Zuweisungsoperator direkt nach der eckigen Endklammer. Zum Beispiel x[y] := z.

Direkt geschriebenes Array. Wenn der eckigen Klammer kein Wert (oder kein Teilausdruck, der einen Wert zurückgibt) vorangestellt ist, wird die Klammer als Beginn eines direkt geschriebenen Arrays interpretiert. Zum Beispiel ist [a, b, c] äquivalent zu Array(a, b, c) (a, b und c sind Variablen).

Weitere Informationen zur allgemeinen Verwendung finden Sie unter Arrays und Maps.

Objektliteral (direkt geschriebenes Objekt). Erstellt ein Objekt. Jedes Paar besteht aus einem direkt geschriebenen Eigenschaftsnamen a und einem Eigenschaftswertausdruck b. Zum Beispiel ist x := {a: b} äquivalent zu x := Object(), x.a := b. Base kann innerhalb des direkt geschriebenen Objekts gesetzt werden, aber alle anderen Eigenschaften werden als eigene Werteigenschaften gesetzt, mit der Möglichkeit (oder Gefahr), die vom Basisobjekt geerbten Eigenschaften zu überschreiben.

Um einen dynamischen Eigenschaftsnamen zu verwenden, umschließen Sie den Teilausdruck mit Prozentzeichen. Zum Beispiel: {%NameVar%: WertVar}.

Kann verwendet werden, um das aktuelle Arbeitsverzeichnis des Skripts abzurufen oder zu setzen, von dem aus das Skript standardmäßig auf Dateien zugreift. Der letzte umgekehrte Schrägstrich ist nicht enthalten, es sei denn, es handelt sich um das Stammverzeichnis. Zwei Beispiele: C:\ und C:\Meine Dokumente.

SetWorkingDir kann auch verwendet werden, um das Arbeitsverzeichnis zu ändern.

Das Arbeitsverzeichnis des Skripts ist standardmäßig immer A_ScriptDir, egal wie das Skript gestartet wurde.

Der vollständige Pfadname des Verzeichnisses, das das aktuelle Skript enthält. Der letzte umgekehrte Schrägstrich wird weggelassen (auch bei Stammverzeichnissen).

Wenn der Skripttext nicht aus der Datei, sondern aus der Standardeingabe (stdin) gelesen wird, enthält diese Variable das anfängliche Arbeitsverzeichnis.

Kann verwendet werden, um den Standardtitel für MsgBox, InputBox, FileSelect, DirSelect und Gui abzurufen oder zu setzen. Wenn nicht vom Skript gesetzt, enthält diese Variable den Dateinamen des aktuellen Skripts, ohne Pfad, z.B. MeinSkript.ahk.

Wenn der Skripttext nicht aus der Datei, sondern aus der Standardeingabe (stdin) gelesen wird, enthält diese Variable ein Sternchen (*).

Wenn das Skript kompiliert oder eingebettet ist, enthält diese Variable den Namen der aktuellen EXE-Datei.

Der vollständige Pfadname des aktuellen Skripts, z.B. C:\Skripte\MeinSkript.ahk

Wenn der Skripttext nicht aus der Datei, sondern aus der Standardeingabe (stdin) gelesen wird, enthält diese Variable ein Sternchen (*).

Wenn das Skript kompiliert oder eingebettet ist, enthält diese Variable den vollständigen Pfadnamen der aktuellen EXE-Datei.

Die Nummer der aktuell ausgeführten Zeile innerhalb des Skripts (oder innerhalb einer #Include-Datei, falls vorhanden). Diese Zeilennummer entspricht der via ListLines angezeigten Zeilennummer; dies ist z.B. nützlich, um einen Fehler zu melden: MsgBox "Konnte nicht in die Logdatei schreiben (Zeile Nr. " A_LineNumber ")".

Da bei einer Skriptkompilierung alle #Include-Dateien zu einem großen Skript zusammengefasst werden, kann die Zeilennummerierung von der im unkompilierten Modus abweichen.

Der vollständige Pfadname der Datei, zu der A_LineNumber gehört. Wenn das Skript aus einer externen Datei geladen wurde, ist diese Variable äquivalent zu A_ScriptFullPath, es sei denn, die Zeile gehört zu einer der #Include-Dateien des Skripts.

Wenn das Skript mit einer BIN-Datei kompiliert wurde, enthält diese Variable den vollständigen Pfadnamen der aktuellen EXE-Datei, äquivalent zu A_ScriptFullPath.

Wenn das Skript eingebettet ist, enthält A_LineFile ein Sternchen (*), gefolgt vom Namen der Ressource; z.B. *#1

Für unkompilierte oder eingebettete Skripte: Der vollständige Pfadname der EXE-Datei, mit der das aktuelle Skript gerade ausgeführt wird. Zum Beispiel: C:\Program Files\AutoHotkey\AutoHotkey.exe

Für kompilierte Skripte, die auf einer BIN-Datei basieren, wird der Wert ermittelt, indem das Installationsverzeichnis aus der Registry gelesen und "\AutoHotkey.exe" angefügt wird. Wenn AutoHotkey nicht installiert ist, ist der Wert leer. Das folgende Beispiel ist äquivalent:

InstallDir := RegRead("HKLM\SOFTWARE\AutoHotkey", "InstallDir", "")
AhkPath := InstallDir ? InstallDir "\AutoHotkey.exe" : ""

Für kompilierte Skripte, die auf einer EXE-Datei basieren, enthält A_AhkPath den vollständigen Pfadnamen des kompilierten Skripts. Dies kann in Kombination mit /script verwendet werden, um externe Skripte auszuführen. Um stattdessen die installierte Kopie von AutoHotkey zu lokalisieren, lesen Sie die Registry wie oben gezeigt.

Das aktuelle 4-stellige Jahr (z.B. 2004). A_Year enthält denselben Wert.

Hinweis: Um die formatierte Version einer Uhrzeit oder eines Datums gemäß Ihrer aktuellen Sprach- und Regionseinstellungen abzurufen, verwenden Sie FormatTime() (Uhrzeit und langes Datum) oder FormatTime(, "LongDate") (langes Datumformat).

Die aktuelle 2-stellige Minute (00-59).

Die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format.

Hinweis: Datums- und Zeitberechnungen können mit DateAdd und DateDiff durchgeführt werden. Außerdem können Sie FormatTime verwenden, um das Datum und/oder die Uhrzeit gemäß Ihrer aktuellen Sprach- und Regionseinstellungen zu formatieren.

Die seit dem Systemstart verstrichene Zeit in Millisekunden, bis zu einem Maximum von 49,7 Tagen. Um diese verstrichene Zeit zu messen, speichern Sie A_TickCount in eine Variable und subtrahieren Sie diese später vom aktuellen A_TickCount-Wert. Zum Beispiel:

StartZeit := A_TickCount
Sleep 1000
VerstricheneZeit := A_TickCount - StartZeit
MsgBox VerstricheneZeit " Millisekunden sind verstrichen."

Wenn Sie eine höhere Genauigkeit als die 10 ms von A_TickCount benötigen, verwenden Sie QueryPerformanceCounter().

Gibt ein Menu-Objekt zurück, mit dem das Tray-Menü geändert oder angezeigt werden kann.

Kann verwendet werden, um abzurufen oder festzulegen, ob das Hauptfenster des Skripts über das Tray-Symbol geöffnet werden darf. Mögliche Werte sind 0 (verboten) und 1 (erlaubt).

Wenn das Skript weder kompiliert noch eingebettet ist, wird diese Variable standardmäßig auf 1 gesetzt, andernfalls wird diese Variable standardmäßig auf 0 gesetzt, kann aber durch Zuweisung eines Wertes überschrieben werden. Diese Variable auf 1 zu setzen, stellt auch den Menüpunkt "Open" im Tray-Menü wieder her und aktiviert die Menüpunkte im View-Menü des versteckten Hauptfensters des Skripts, wie z.B. "Lines most recently executed", was den Quellcode des Skripts und andere Informationen anzeigt.

Die folgenden Funktionen sind immer in der Lage, das Hauptfenster zu öffnen und die entsprechenden View-Optionen auszuwählen, wenn sie während der Skriptausführung erreicht werden: ListLines, ListVars, ListHotkeys und KeyHistory.

Die Variable auf 1 zu setzen, verhindert nicht, dass das Hauptfenster mit WinShow sichtbar gemacht oder mit ControlGetText oder ähnlichem inspiziert werden kann, verhindert aber, dass der Quellcode des Skripts und andere Informationen via Hauptfenster preisgegeben werden, außer wenn eine der oben aufgeführten Funktionen vom Skript aufgerufen wird.

Kann verwendet werden, um den Tooltiptext des Tray-Symbols abzurufen oder zu setzen; dieser wird angezeigt, wenn sich der Mauszeiger darüber befindet. Wenn leer, wird stattdessen der Name des Skripts verwendet.

Um einen Tooltip mehrzeilig zu machen, trennen Sie jede Zeile mit einem Zeilenvorschubzeichen (`n), z.B. "Zeile1`nZeile2". Es werden nur die ersten 127 Zeichen angezeigt. Außerdem wird der Text am ersten Tabulatorzeichen abgeschnitten, falls vorhanden.

Windows 10 und niedriger: Um ein Und-Zeichen (&) im Tooltip anzuzeigen, versehen Sie es mit zwei zusätzlichen Und-Zeichen. Zum Beispiel bewirkt "A &&& B", dass "A & B" im Tooltip angezeigt wird.

Die Zeit in Millisekunden, die seit der letzten Eingabe via Tastatur, Maus usw. verstrichen ist. Dies ist nützlich, um festzustellen, ob der Benutzer abwesend ist. Physische Benutzereingaben sowie künstlich erzeugte Eingaben durch ein beliebiges Programm oder Skript (z.B. via Send- oder MouseMove-Funktion) setzen diesen Wert auf 0 zurück. Da dieser Wert tendenziell in 10er-Schritten ansteigt, sollte nicht geprüft werden, ob er mit einem anderen Wert übereinstimmt. Prüfen Sie stattdessen, ob dieser Wert größer oder kleiner als ein anderer Wert ist. Zum Beispiel:

if A_TimeIdle > 600000
    MsgBox "Die letzte Aktivität war vor 10 Minuten"

Der zuletzt ausgeführte Hotkey oder nicht-automatisch-ersetzende Hotstring (andernfalls leer), z.B. #z. Dieser Wert ändert sich, wenn der aktuelle Thread von einem anderen Hotkey oder Hotstring unterbrochen wird, deshalb ist es in der Regel besser, den Parameter ThisHotkey nach Möglichkeit zu verwenden.

Jeder neu erstellte Hotkey - entweder via Hotkey-Funktion oder Zweifach-Doppelpunkt-Syntax - erhält einen festen Namen, der sich aus dem Tastennamen und der Reihenfolge der Modifikatorsymbolen zusammensetzt und von allen Varianten des Hotkeys verwendet wird.

Jeder neu erstellte Hotstring - entweder via Hotstring-Funktion oder Zweifach-Doppelpunkt-Label - erhält einen festen Namen, der sich aus der auslösenden Zeichenkette und der Sequenz von Optionszeichen zusammensetzt.

Enthält dieselbe Zeichenkette wie die ComSpec-Umgebungsvariable, was üblicherweise der vollständige Pfad zur ausführbaren Datei der Eingabeaufforderung (cmd.exe) ist. Diese Variable wird oft mit Run/RunWait verwendet. Zum Beispiel:

C:\Windows\system32\cmd.exe

Der vollständige Pfadname des Ordners zum Speichern von temporären Dateien. Folgende Orte werden der Reihenfolge nach durchsucht, um den Pfadnamen zu ermitteln: 1) Umgebungsvariable TMP, TEMP oder USERPROFILE; 2) Windows-Verzeichnis. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Local\Temp

Die Versionsnummer des Betriebssystems im Format "Haupt.Neben.Build". Windows 7 SP1 ist beispielsweise 6.1.7601.

Beachten Sie, dass das Betriebssystem eine andere Versionsnummer meldet bzw. A_OSVersion einen anderen Wert enthält, wenn der Kompatibilitätsmodus im Eigenschaftenfenster der AutoHotkey-EXE-Datei oder des kompilierten Skripts eingeschaltet wurde.

Das Verzeichnis der Programmdateien (z.B. C:\Programme oder C:\Programme (x86)). Die Umgebungsvariable ProgramFiles enthält üblicherweise denselben Wert.

Für 64-Bit-Systeme (nicht 32-Bit-Systeme) gilt folgendes:

• Wenn die EXE-Datei, mit der das Skript ausgeführt wird, 32-Bit ist, enthält A_ProgramFiles den Pfadnamen des Ordners "Programme (x86)".
• Für 32-Bit-Prozesse enthält die Umgebungsvariable ProgramW6432 den Pfadnamen des 64-Bit-Ordners "Programme". In Windows 7 und höher wird sie auch für 64-Bit-Prozesse gesetzt.
• Die Umgebungsvariable ProgramFiles(x86) enthält den Pfadnamen des 32-Bit-Ordners "Programme (x86)".

Der vollständige Pfadname des Ordners, der anwendungsspezifische Daten des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming

Der vollständige Pfadname des Ordners, der anwendungsspezifische Daten aller Benutzer enthält. Zum Beispiel:

C:\ProgramData

Der vollständige Pfadname des Ordners, der die Desktop-Dateien des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\Desktop

Der vollständige Pfadname des Ordners, der die Desktop-Dateien aller Benutzer enthält. Zum Beispiel:

C:\Users\Public\Desktop

Der vollständige Pfadname des Ordners, der die Startmenü-Dateien des aktuellen Benutzers enthält. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu

Der vollständige Pfadname des Ordners, der die Startmenü-Dateien aller Benutzer enthält. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu

Der vollständige Pfadname des Startmenü-Ordners "Programme" des aktuellen Benutzers. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs

Der vollständige Pfadname des Startmenü-Ordners "Programme" aller Benutzer. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs

Der vollständige Pfadname des Startmenü-Ordners "Autostart" des aktuellen Benutzers. Zum Beispiel:

C:\Users\<Benutzer>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

Der vollständige Pfadname des Startmenü-Ordners "Autostart" aller Benutzer. Zum Beispiel:

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

Der vollständige Pfadname des Ordners "Dokumente", der beliebige Dateien (vorzugsweise Dokumente) des aktuellen Benutzers enthält. Im Gegensatz zu den meisten anderen ähnlichen Variablen wird, wenn der Ordner das Stammverzeichnis eines Laufwerks ist, der umgekehrte Schrägstrich am Ende weggelassen (z.B. M: statt M:\). Zum Beispiel:

C:\Users\<Benutzer>\Documents

Enthält 1, wenn der aktuelle Benutzer Adminrechte hat, andernfalls 0.

Wenn das Skript sich selbst mit Adminrechten neu starten soll (oder um diese Rechte vom Benutzer via Dialogfenster einzufordern), verwenden Sie Run *RunAs. Beachten Sie aber, dass die Skriptausführung als Administrator dazu führt, dass alle Programme, die vom Skript gestartet werden, ebenfalls als Administrator ausgeführt werden. Eine mögliche Alternative finden Sie in der FAQ.

A_ScreenWidth
A_ScreenHeight

Die Breite und Höhe des primären Bildschirms in Pixel (z.B. 1024 und 768).

Mit SysGet können die Dimensionen von nicht-primären Bildschirmen abgerufen werden.

Um stattdessen die Breite und Höhe des gesamten Desktops abzurufen (selbst wenn er sich über mehrere Bildschirme erstreckt), verwenden Sie folgendes Beispiel:

VirtuelleBreite := SysGet(78)
VirtuelleHöhe := SysGet(79)

Mit SysGet kann auch der Arbeitsbereich eines Bildschirms abgerufen werden. Dieser Bereich ist in der Regel kleiner als der gesamte Bildschirmbereich, da die Taskleiste und andere registrierte Desktopsymbolleisten ausgeschlossen werden.

Der Typ des aktuell angezeigten Mauszeigers. Die Variable enthält eines der folgenden Wörter: AppStarting, Arrow, Cross, Help, IBeam, Icon, No, Size, SizeAll, SizeNESW, SizeNS, SizeNWSE, SizeWE, UpArrow, Wait, Unknown. Die Großbuchstaben hinter Size sind Himmelsrichtungen, z.B. NESW = NorthEast+SouthWest (Nordost+Südwest). Die handförmigen Mauszeiger (Zeigen und Greifen) sind als Unknown klassifiziert.

Enthält zusätzliche Informationen über die folgenden Ereignisse:

• Mausrad-Hotkeys (WheelDown/Up/Left/Right)
• OnMessage
• Callouts in Regulären Ausdrücken

Hinweis: Jeder Thread hat seinen eigenen Wert für A_EventInfo (im Gegensatz zu Variablen wie A_ThisHotkey). Wenn also ein Thread von einem anderen unterbrochen wird, sieht er bei seiner Wiederaufnahme immer noch seine ursprünglichen/korrekten Werte in diesen Variablen.

A_EventInfo kann auch vom Skript gesetzt werden, akzeptiert aber nur vorzeichenlose Integer innerhalb eines Zahlenbereichs, der für Pointer üblich ist (je nach AutoHotkey-Version entweder 32-Bit oder 64-Bit).

Diese Variable ist üblicherweise das Ergebnis der Systemfunktion GetLastError(), nachdem das Skript bestimmte Funktionen wie z.B. DllCall, Run/RunWait und File/Ini/Reg-Funktionen (wo dokumentiert) aufgerufen hat. A_LastError ist eine Zahl zwischen 0 und 4294967295 (immer dezimal, nicht hexadezimal). Null (0) bedeutet Erfolg, während jede andere Zahl bedeutet, dass der Aufruf fehlgeschlagen ist. Jede Nummer entspricht einem bestimmten Fehlerzustand. Unter OSError erfahren Sie, wie der lokalisierte Fehlerbeschreibungstext abgerufen werden kann, oder suchen Sie auf www.microsoft.com nach "system error codes", um eine Liste zu erhalten. A_LastError ist eine threadspezifische Einstellung, d.h. es kann nicht durch Unterbrechungen anderer Threads geändert werden.

Beim Zuweisen eines Wertes an A_LastError wird auch die Systemfunktion SetLastError() aufgerufen.

Enthalten 1 und 0. Diese können verwendet werden, um die Lesbarkeit eines Skripts zu verbessern. Einzelheiten finden Sie unter Boolesche Werte.

Dies sind Schlüsselwörter, keine Variablen.