Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Recherche un tableau pour l’élément spécifié et retourne sa position.
Syntaxe
array_index_of(
valeur de tableau,
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Catégorie | Requise | Descriptif |
|---|---|---|---|
| tableau | dynamic |
✔️ | Tableau à rechercher. |
| valeur | long, int, datetime, timespan, string, guid ou bool | ✔️ | Valeur à rechercher. |
| commencer | 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) . |
|
| longueur | 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).
Exemples
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.