Functions > String >


StringInStr

Vérifie si une chaîne contient une sous-chaîne donnée.

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)