Condividi tramite

array_index_of()

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

Cerca in una matrice l'elemento specificato e ne restituisce la posizione.

Sintassi

array_index_of(array, value [ start [,, length [, occurrence ]]])

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome Digita Obbligatorio Descrizione
array dynamic ✔️ Matrice da cercare.
value long, int, datetime, timespan, string, guid o bool ✔️ Valore da cercare.
start int Posizione iniziale della ricerca. Un valore negativo sfalserà il valore di ricerca iniziale dalla fine della matrice eseguendo abs(i passaggi iniziali) .
length int Numero di valori da esaminare. Il valore -1 indica una lunghezza illimitata.
occurrence int Numero dell'occorrenza. Il valore predefinito è 1.

Valori restituiti

Restituisce una posizione di indice in base zero della ricerca. Restituisce -1 se il valore non viene trovato nella matrice. Restituisce Null per gli input irrilevanti (occorrenza< 0 o lunghezza< -1).

Esempio

Nell'esempio seguente viene illustrato il numero di posizioni di parole specifiche all'interno della matrice.

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

Contenuto correlato

Usare set_has_element(arr, value) per verificare se un valore esiste in una matrice. Questa funzione migliorerà la leggibilità della query. Entrambe le funzioni hanno le stesse prestazioni.