Functions > String >


StringInStr

Recherche la position d'une sous-cha�ne dans une cha�ne.

StringInStr ( "string", "substring" [, casesense = 0 [, occurrence = 1 [, start = 1 [, count]]]] )

Param�tres

string La cha�ne � analyser.
substring La sous-cha�ne � rechercher.
casesense [optionnel] Flag pour indiquer si les op�rations doivent �tre sensibles � la casse.
    $STR_NOCASESENSE (0) = insensible � la casse, utilise les param�tres locaux de l'utilisateur (par d�faut)
    $STR_CASESENSE (1) = sensible � la casse
    $STR_NOCASESENSEBASIC (2) = insensible � la casse, utilise une comparaison simple/rapide

Les constantes sont d�finies dans "StringConstants.au3"
occurrence [optionnel] L'occurrence de la sous-cha�ne � trouver dans la cha�ne. Utiliser une occurrence n�gative pour rechercher � partir de la droite de la cha�ne. La valeur par d�faut est 1 (trouve la premi�re occurrence).
start [optionnel] La position de d�part de la recherche.
count [optionnel] Le nombre de caract�res � traiter. Ceci limite la recherche � une partie de la cha�ne compl�te. Voir Remarques.

Valeur de retour

Succ�s: Retourne la position de la sous-cha�ne.
�chec: Retourne 0 si la sous-cha�ne n'est pas trouv�e.
@error: 1 = Param�tres 'start' ou 'occurrence' invalide.

Remarques

La position du premier caract�re est 1.

Le param�tre 'count' doit �tre plus court que la sous-cha�ne recherch�e. Le param�tre 'count' (combin� avec le param�tre 'start') limite efficacement la recherche � une sous-cha�ne de la cha�ne compl�te. Les instructions suivantes sont �quivalentes:
StringInStr("La cha�ne � chercher", "cha�ne", 0, 1, 1, 11)
StringInStr(StringMid("La cha�ne � chercher", 1, 11), "cha�ne")

En relation

StringCompare, StringLeft, StringLen, StringLower, StringMid, StringRegExp, StringRight, StringSplit, StringTrimLeft, StringTrimRight, StringUpper

Exemple

#include <MsgBoxConstants.au3>

; R�cup�re la position du caract�re � l'endroit o� la cha�ne 'white' appara�t la premi�re fois dans la phrase.
Local $iPosition = StringInStr("Ceci est une phrase avec whitespace.", "white")
MsgBox($MB_SYSTEMMODAL, "", "La cha�ne cherch�e 'white' apparait le premi�re fois � la position: " & $iPosition)