array_index_of()

Zoekt in een matrix naar het opgegeven item en retourneert de positie ervan.

Syntax

array_index_of(Array,waarde [,begin [,lengte [,exemplaar ]]])

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
Array	dynamic	✔️	De matrix die moet worden gezocht.
value	long, int, datetime, timespan, string, guid of bool	✔️	De waarde die moet worden gezocht.
start	int		De beginpositie van de zoekopdracht. Een negatieve waarde verschoven de beginzoekwaarde vanaf het einde van de matrix door abs(de beginstappen) .
length	int		Het aantal waarden dat moet worden onderzocht. Een waarde van -1 betekent een onbeperkte lengte.
Voorkomen	int		Het nummer van de gebeurtenis. De standaardwaarde is 1.

Retouren

Retourneert een op nul gebaseerde indexpositie van opzoeken. Retourneert -1 als de waarde niet wordt gevonden in de matrix. Retourneert null voor irrelevante invoer (exemplaar< 0 of lengte< -1).

Voorbeeld

In het volgende voorbeeld ziet u het positienummer van specifieke woorden in de matrix.

De query uitvoeren

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

Uitvoer

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

Gerelateerde inhoud

Gebruik set_has_element(arr, value) om te controleren of een waarde bestaat in een matrix. Deze functie verbetert de leesbaarheid van uw query. Beide functies hebben dezelfde prestaties.