Enumerator-Objekt [AHK_L 49+]

Next

Ruft das nächste Element in einer Enumeration ab.

Boolesch := Enum.Next(AusgabeVar1 , AusgabeVar2, ...)

Parameter

AusgabeVar1, AusgabeVar2

Erhält einen implementierungsspezifischen Wert.

...

Zusätzliche Parameter, falls unterstützt.

Rückgabewert

Diese Methode gibt 1 (true) zurück, wenn sie erfolgreich war, oder 0 (false), wenn keine Elemente mehr übrig sind.

Bemerkungen

Die von ObjNewEnum() zurückgegebenen Enumeratoren werden für jedes Schlüssel-Wert-Paar einmal aufgerufen, und erlauben bis zu zwei Parameter:

• AusgabeVar1: Empfängt den Schlüssel eines Schlüssel-Wert-Paares.
• AusgabeVar2: Empfängt den Wert bezüglich AusgabeVar1.

Schlüssel-Wert-Paare werden in einer implementierungsdefinierten Reihenfolge zurückgegeben. Das bedeutet, dass sie typischerweise nicht in der Reihenfolge zurückgegeben werden, in der sie zugewiesen wurden. Existierende Schlüssel-Wert-Paare können während der Enumeration geändert werden, aber das Einfügen oder Entfernen von Schlüsseln kann dazu führen, dass einige Datensätze übersprungen oder mehrfach enumeriert werden.

Siehe auch

For-Schleife, Objekt._NewEnum()

Beispiele

; Einige Beispieldaten erstellen.
obj := Object("rot", 0xFF0000, "blau", 0x0000FF, "grün", 0x00FF00)

; Enumerieren!
enum := obj._NewEnum()
While enum[k, v]
    t .= k "=" v "`n"
MsgBox % t

; Benötigt [AHK_L 59+]
For k, v in obj
    s .= k "=" v "`n"
MsgBox % s