indexof()

S’applique à : ✅Microsoft Fabric

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. La fonction indexof() respecte la casse. Pour effectuer une recherche sans respect de la casse, envisagez d’utiliser tolower() ou toupper() sur les deux entrées.

Pour plus d’informations, consultez indexof_regex().

Syntaxe

indexof( occurrence de longueur,[,

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Catégorie	Requise	Descriptif
chaîne de caractères	string	✔️	Chaîne source à rechercher.
allumette	string	✔️	Chaîne pour laquelle effectuer une recherche.
démarrer	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
longueur	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

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