array_index_of()

Durchsucht ein Array nach dem angegebenen Element und gibt seine Position zurück.

Syntax

array_index_of(Array,Wert [,start [,length [,occurrence ]]])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
array	dynamic	✔️	Das Array, das durchsucht werden soll.
value	long, int, datetime, timespan, string, guid oder bool	✔️	Der nachschlagende Wert.
start	int		Die Startposition der Suche. Ein negativer Wert versetzt den Anfangssuchwert vom Ende des Arrays nach abs(Startschritten) .
length	int		Die Anzahl der zu untersuchenden Werte. Ein Wert von -1 bedeutet unbegrenzte Länge.
occurrence	int		Die Nummer des Vorkommens. Der Standardwert ist 1.

Gibt zurück

Gibt eine nullbasierte Indexposition der Suche zurück. Gibt -1 zurück, wenn der Wert nicht im Array gefunden wird. Gibt null für irrelevante Eingaben zurück (Vorkommen< 0 oder Länge< -1).

Beispiel

Das folgende Beispiel zeigt die Positionsnummer bestimmter Wörter innerhalb des Arrays.

Abfrage ausführen

let arr=dynamic(["this", "is", "an", "example", "an", "example"]);
print
 idx1 = array_index_of(arr,"an")    // lookup found in input string
 , idx2 = array_index_of(arr,"example",1,3) // lookup found in researched range 
 , idx3 = array_index_of(arr,"example",1,2) // search starts from index 1, but stops after 2 values, so lookup can't be found
 , idx4 = array_index_of(arr,"is",2,4) // search starts after occurrence of lookup
 , idx5 = array_index_of(arr,"example",2,-1)  // lookup found
 , idx6 = array_index_of(arr, "an", 1, -1, 2)   // second occurrence found in input range
 , idx7 = array_index_of(arr, "an", 1, -1, 3)   // no third occurrence in input array
 , idx8 = array_index_of(arr, "an", -3)   // negative start index will look at last 3 elements
 , idx9 = array_index_of(arr, "is", -4)   // negative start index will look at last 3 elements

Ausgabe

idx1	idx2	idx3	idx4	idx5	idx6	idx7	idx8	idx9
2	3	-1	-1	3	4	-1	4	-1

Verwandte Inhalte

Verwenden Sie set_has_element(arr, ), um zu überprüfen, value ob ein Wert in einem Array vorhanden ist. Diese Funktion verbessert die Lesbarkeit Ihrer Abfrage. Beide Funktionen haben die gleiche Leistung.