array_index_of()

Gilt für: ✅Microsoft Fabric

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

Syntax

array_index_of( Arraywert,[ Start [,, Länge [,Vorkommen ]]])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Typ	Erforderlich	Beschreibung
Anordnung	dynamic	✔️	Das zu durchsuchende Array.
Wert	long, int, datetime, timespan, string, guid oder bool	✔️	Der wert, der nachschlagen soll.
starten	int		Die Startposition der Suche. Ein negativer Wert versetzt den Anfangssuchwert vom Ende des Arrays durch abs(Die ersten) Schritte.
Länge	int		Die Anzahl der zu untersuchenden Werte. Ein Wert von -1 bedeutet eine unbegrenzte Länge.
Ereignis	int		Die Nummer des Vorkommens. Der Standardwert ist 1.

Gibt zurück

Gibt eine nullbasierte Indexposition des Nachschlagevorgangs 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).

Beispiele

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

Zugehöriger Inhalt

Verwenden Sie arr um zu überprüfen, valueob ein Wert in einem Array vorhanden ist. Diese Funktion verbessert die Lesbarkeit Ihrer Abfrage. Beide Funktionen weisen die gleiche Leistung auf.