DESCRIPTION.

La fonction FN_findreplacei() recherche insensiblement à la casse, et remplace, dans une variable de type $, une suite de caractères par une autre.

SYNTAXE.

kquantite = FN_findreplacei( variable , actuelle , nouvelle , debut )

REMARQUES.

variable doit être obligatoirement l'identifiant d'une variable de type chaine de caractères ($) existante.

actuelle et nouvelle doivent être des chaines de caractères, quelconques mais valides.

debut doit être un nombre entier, indiquant la position du premièr caractères de variable où doit commencer la recherche.

L'appel de la fonction FN_findreplacei() va rechercher dans variable, à partir du caractère à la position debut, toutes les suites de caractères exactement égales actuelle et les remplacera par nouvelle, dans variable elle-même. La fonction FN_findreplacei() retourne une valeur numérique indiquant combien de fois un remplacement s'est produit.

Note : les recherches effectuées par la fonction FN_findreplacei() sont insensibles à la casse, c'est-à-dire qu'une lettre majuscule est égale de sa valeur minuscule. Pour faire des recherches sensible à la casse, utilisez la fonction FN_findreplace(). 

Rappel : La fonction FN_findreplacei() ne retourne pas une nouvelle variable de type $, mais modifie bien variable. c'est pourquoi il est très important de s'assurer que variable existe bien avant d'appeler cette fonction.

La fonction FN_findreplacei() est importée depuis le module stringlib.bbc. 

EXEMPLE.

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "stringlib.bbc"

ktest$ = "AAC basic for SDL 2.0"

kquantite = FN_findreplacei( ktest$ , "A" , "B" , 0 )

PRINT "Valeur modifiee : " ; ktest$

PRINT "Nombre d'occurrence(s) trouvee(s) : " ; kquantite