Partager via

indexof()

  • Article

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().

Syntax

indexof(String,correspondance[,Commencer[,Longueur[,Occurrence]]])

Découvrez les conventions de syntaxe.

Paramètres

Nom Type Obligatoire Description
string string ✔️ Chaîne source à rechercher.
correspondance 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 par ces nombreuses étapes : abs(démarrer).
length int Nombre de positions de caractère à examiner. La valeur -1 signifie longueur illimitée.
occurrence int Numéro de l’occurrence. La valeur par défaut est 1.

Notes

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

Retours

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

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

Exemples

Exécuter la requête

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