Freigeben über

array_index_of()

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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 Type Erforderlich Beschreibung
array dynamic ✔️ Das zu durchsuchende Array.
value long, int, datetime, timespan, string, guid oder bool ✔️ Der wert, der nachschlagen soll.
start int Die Startposition der Suche. Ein negativer Wert versetzt den Anfangssuchwert vom Ende des Arrays durch abs(Die ersten) Schritte.
length int Die Anzahl der zu untersuchenden Werte. Ein Wert von -1 bedeutet eine unbegrenzte Länge.
occurrence 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).

Beispiel

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

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

Output

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

Zugehöriger Inhalt

Verwenden Sie set_has_element(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.