array_index_of()
Recherche l’élément spécifié dans un tableau et retourne sa position.
Syntax
array_index_of(
Array,
value [,
start [,
length [,
occurrence ]]])
Découvrez les conventions de syntaxe.
Paramètres
Nom | Type | Obligatoire | Description |
---|---|---|---|
array | dynamic |
✔️ | Tableau à rechercher. |
value | 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ébut à partir de la fin du tableau par abs( les étapes de début) . |
|
length | int |
Nombre de valeurs à examiner. La valeur -1 signifie longueur illimitée. | |
occurrence | int |
Numéro 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 est introuvable dans le tableau. Retourne null pour les entrées non pertinentes (occurrence< 0 ou longueur< -1).
Exemple
L’exemple suivant montre le nombre de positions 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 case activée 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.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour