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: