FIND
Verwenden Sie die Script-Funktion "FIND", um ein Script-Array zu durchsuchen und die entsprechende Indexposition zurückzugeben.
Syntax
FIND (Script-Array, String [, Startindex] )
Parameter
-
FIND
Durchsucht das Script-Array -
Script-Array
Name des Script-Arrays, das durchgesucht werden soll -
String
String oder Zahl, nach dem bzw. der gesucht werden soll
Format: String-Literal, Zahl ohne Anführungszeichen oder eine Script-Variable -
Startindex
(Optional) Index, an dem die Suche beginnen soll
Format: Zahl ohne Anführungszeichen oder eine Script-Variable
Rückgabewerte
- Index des Arrays, in dem sich der Suchschlüssel befindet
- 0, wenn es kein Suchergebnis gibt
Hinweise:
- Die Suche nach einem Suchschlüsselwird 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 Arrays 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 in der :SET-Anweisung 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 erstellt und initiiert ein Array mit VARA-Objektwerten. Das Script sucht nach dem String 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 gefunden an Position &search#"
:SET &search# = &search# + 1
:SET &search# = FIND(&array#[], "WIN", &search#)
:ENDWHILE
Siehe auch: