Verwenden Sie die Script-Funktion „FIND“, um ein Script-Array zu durchsuchen und die entsprechende Indexposition zurückzugeben.
Syntax
FIND (script array, string [, start index] )
Parameter
- FIND
Durchsucht das Script-Array - script array
Name des Script-Arrays, nach dem gesucht werden soll - string
Zeichenfolge oder Zahl, nach der gesucht werden soll
Format: String-Literal, Zahl ohne Hochkommata, oder eine Script-Variable - start index
(Optional) Index, ab dem die Suche gestartet werden soll
Format: Zahl ohne Hochkommata, oder eine Script-Variable
Rückgabewerte
- Index des Arrays, in dem sich der Suchbegriff befindet
- 0 wenn es kein Suchergebnis gibt
Hinweise:
- Die Suche nach Suchbegriff wird für alle Werte von Script-Array ab dem Index Startposition durchgeführt.
- Wird keine Startposition angegeben, wird das ganze Array, ab Index 1, durchsucht.
- War die Suche erfolgreich, wird der Array-Index zurückgeliefert, in dem der Text bzw. die Zahl als erstes gefunden wurde. Um die Suche im restlichen Teil des Array fortzusetzen, ist als Startposition der nächste Index des vorigen Ergebnisses zu verwenden.
- Geben Sie Arrays mit leeren eckigen Klammern an.
Tipps:
- Verwenden Sie :DEFINE, um Script-Arrays zu erstellen und den Datentyp und die Größe des Arrays zu deklarieren.
- Setzen Sie einzelne Array-Elemente und geben Sie den Index im :SET-Statement an.
- Verwenden Sie :FILL, um mehrere Werte in einem Array auf einmal zu speichern.
Weitere Informationen zu Script-Arrays finden Sie unter Arrays.
Beispiele
Das folgende Beispiel zeigt die Erstellung und Initialisierung eines Arrays mit Werten aus einem Variablenobjekt. Das Script sucht nach der Zeichenfolge WIN im gesamten Array. Die Ergebnisse werden in den Aktivierungsreport geschrieben.
:DEFINE &array#, string, 5
:FILL &array#[] = GET_VAR(VARA.WIN, AGENTS)
:SET &search# = FIND(&array#[], "WIN", 1)
:WHILE &search# <> 0
:PRINT "WIN found at position &search#"
:SET &search# = &search# + 1
:SET &search# = FIND(&array#[], "WIN", &search#)
:ENDWHILE
Siehe auch: