Manuel des Scripts Automation Engine > Organisation fonctionnelle > Chaînes de caractères > STR_FIND

STR_FIND

Fonction script : Recherche un caractère ou une chaîne de caractères dans une chaîne de caractères.

Syntaxe

STR_FIND(chaîne de caractères1, chaîne de caractères2[, Start])

Elément de syntaxe	Description/format
Chaîne de caractères1	Chaîne de caractères alphanumérique dans laquelle la recherche doit avoir lieu. Format : Littéral de Script ou Variable de Script
Chaîne de caractères2	Caractère unique ou chaîne de caractères alphanumérique recherché(e). Format : Littéral de Script ou Variable de Script
Début	Position à laquelle la recherche doit commencer. Format : nombre sans guillemets Valeur par défaut : 1

Codes retour
Position à laquelle le caractère ou la chaîne de caractères a été trouvé(e). "0" - Le caractère ou la chaîne de caractères n'a pas été trouvé(e).

Remarques

La fonction recherche la chaîne de caractères2 dans la chaîne de caractères1 et commence donc la recherche à partir de Start. Si la position Start n'est pas indiquée, la recherche débute en position 1. La chaîne de caractères2 peut se composer d'un seul caractère. La recherche n'est pas sensible à la casse. Les majuscules et minuscules ne sont donc pas prises en compte.

La fonction script indique de nouveau la première position à laquelle la chaîne de caractères2 a été trouvée comme valeur. La position est donc toujours comptée depuis le début de la chaîne de caractères1, pas à partir de Start.

Exemple

Dans l'exemple, la recherche retourne à nouveau la valeur 8 après "#" dans la chaîne de caractères "Automic#01, Automic#02". Elle est affichée dans le protocole d'activation.

:SET &CHAINE#="Automic#01, Automic#02"
:SET &CHAINE_RECHERCHE#="#"
:SET &POS#=STR_FIND(&CHAINE#,&CHAINE_RECHERCHE#)
:PRINT &POS#

Dans l'exemple suivant, la recherche débute en position 2. La position à laquelle la chaîne de caractères a été trouvée est la position 13.

:SET &POS#=STR_FIND("Automic#01, Automic#02","Automic", 2)
:PRINT &POS#

Rubriques connexes :

Eléments de script	Description
STR_FIND_REVERSE	Recherche un caractère ou une chaîne de caractères dans une chaîne de caractères. La recherche commence à la fin de la chaîne de caractères à rechercher.

Eléments de script - Chaînes de caractères

Exemples
Alerte avec texte du message Variable

Généralités sur les Scripts
Elément de script - Liste alphabétique
Elément de script - Division fonctionnelle