instr permet de rechercher une sous-chaîne donnée dans une chaîne de caractères, à partir d'un caractère de rang donné dans la chaîne.

Syntaxe

   instr( rang, chaîne, sous_chaîne )

Paramètres

Elément

Description

Restrictions

rang

Expression de type Integer donnant le rang qui correspond au 1er caractère de chaîne à partir duquel on recherche la sous-chaîne.

rang >= 0

chaîne

Expression de type Char représentant la chaîne dans laquelle la recherche est faite.

Aucune.

sous_chaîne

Expression de type Char représentant la sous-chaîne recherchée.

Aucune.

Exemples

   # Recherche d'une chaîne de caractères 'ABC' dans une chaîne donnée;
   # avec les paramètres ci-dessous, ce programme affiche 3
    Infbox num$(instr(1,"l'ABC se trouve dans un abécédaire",'ABC'))

   # Compter le nombre de mots MOT dans un texte TEXTE
   # et mettre le résultat dans la variable CPT
    CPT = -1 : I = 0
    Repeat I = instr(I+1, TEXTE, MOT) : CPT += 1 : Until I = 0

Description

instr recherche sous_chaîne dans chaîne à partir de la position rang et donne la position (en nombre de caractères) du premier caractère correspondant à la sous-chaîne recherchée. Si la sous-chaîne n'est pas présente ou si rang <= 0, instr renvoie 0.

Erreurs associées

Erreur

Description

ERMODE (10)

- rang n'est pas de type numérique.
- chaîne ou sous-chaîne n'est pas de type Char.

ERDOM (50)

rang < 0

Mots-clés associés

LEFT$ - RIGHT$ - STRING$ - SPACE$ - SEG$ - MID$ - VIREBLC