Partager via

indexof()

  • Article

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

Signale l’index de base zéro de la première occurrence d’une chaîne spécifiée dans la chaîne d’entrée.

Pour plus d’informations, consultez indexof_regex().

Syntaxe

indexof(occurrence de longueur[,de début[,de correspondance[,de chaîne,]]])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
string string ✔️ Chaîne source à rechercher.
match string ✔️ Chaîne pour laquelle effectuer une recherche.
start int Position de début de la recherche. Une valeur négative décalera la position de recherche de départ de la fin de la chaîne en procédant de nombreuses étapes :abs( début).
length int Nombre de positions de caractère à examiner. La valeur -1 signifie une longueur illimitée.
occurrence int Nombre de l’occurrence. La valeur par défaut est 1.

Remarque

Si la chaîne ou la correspondance n’est pas de type string, la fonction convertit de force leur valeur en string.

Retours

Position d’index de base zéro de correspondance.

  • Retourne -1 si la correspondance n’est pas trouvée dans la chaîne.
  • Retourne null si :
    • le début est inférieur à 0.
    • l’occurrence est inférieure à 0.
    • la longueur est inférieure à -1.

Exemples

print
 idx1 = indexof("abcdefg","cde")    // lookup found in input string
 , idx2 = indexof("abcdefg","cde",1,4) // lookup found in researched range 
 , idx3 = indexof("abcdefg","cde",1,2) // search starts from index 1, but stops after 2 chars, so full lookup can't be found
 , idx4 = indexof("abcdefg","cde",3,4) // search starts after occurrence of lookup
 , idx5 = indexof("abcdefg","cde",-5)  // negative start index
 , idx6 = indexof(1234567,5,1,4)       // two first parameters were forcibly casted to strings "12345" and "5"
 , idx7 = indexof("abcdefg","cde",2,-1)  // lookup found in input string
 , idx8 = indexof("abcdefgabcdefg", "cde", 1, 10, 2)   // lookup found in input range
 , idx9 = indexof("abcdefgabcdefg", "cde", 1, -1, 3)   // the third occurrence of lookup is not in researched range

Sortie

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