Dela via

array_index_of()

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Söker i en matris efter det angivna objektet och returnerar dess position.

Syntax

array_index_of( samling,värde [,start [,längd [,förekomst ]]])

Läs mer om syntaxkonventioner.

Parameterar

Namn Typ Krävs Beskrivning
samling dynamic ✔️ Matrisen som ska sökas.
värde long, int, datetime, timespan, string, guid eller bool ✔️ Det värde som ska sökas upp.
starta int Sökstartpositionen. Ett negativt värde förskjuter det inledande sökvärdet från slutet av matrisen genom abs(startsteg) .
längd int Antalet värden som ska undersökas. Värdet -1 innebär obegränsad längd.
förekomst int Antalet förekomster. Standardvärdet är 1.

Retur

Returnerar en nollbaserad indexposition för sökning. Returnerar -1 om värdet inte hittas i matrisen. Returnerar null för irrelevanta indata (förekomst< 0 eller längd< -1).

Exempel

I följande exempel visas positionsnumret för specifika ord i matrisen.

Kör frågan

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

Resultat

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

Relaterat innehåll

Använd set_has_element(arr, value) för att kontrollera om ett värde finns i en matris. Den här funktionen förbättrar frågans läsbarhet. Båda funktionerna har samma prestanda.