Partager via

array_index_of()

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Recherche un tableau pour l’élément spécifié et retourne sa position.

Syntaxe

array_index_of(valeur de tableau, [, start [ , length [, occurrence ]]])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
array dynamic ✔️ Tableau à rechercher.
valeur long, int, datetime, timespan, string, guid ou bool ✔️ Valeur à rechercher.
start int Position de début de la recherche. Une valeur négative décalera la valeur de recherche de départ de la fin du tableau par abs(étapes de début) .
length int Nombre de valeurs à examiner. La valeur -1 signifie une longueur illimitée.
occurrence int Nombre de l’occurrence. La valeur par défaut est 1.

Retours

Retourne une position d’index de base zéro de la recherche. Retourne -1 si la valeur n’est pas trouvée dans le tableau. Retourne null pour les entrées non pertinentes (occurrence< 0 ou longueur< -1).

Exemple

L’exemple suivant montre le nombre de mots spécifiques dans le tableau.

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

Sortie

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

Contenu connexe

Utilisez set_has_element(arr, value) pour vérifier si une valeur existe dans un tableau. Cette fonction améliore la lisibilité de votre requête. Les deux fonctions ont les mêmes performances.