DESCRIPTION.

La fonction FN_findreplace() recherche et remplace, dans une variable de type $, une suite de caractères par une autre.

SYNTAXE.

kquantite = FN_findreplace( 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 recheche.

L'appel de la fonction FN_findreplace() 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_findreplace() retourne une valeur numérique indiquant combien de fois un remplacement s'est produit.

Note : la fonction FN_findreplace() est sensible à la casse, c'est-à-dire qu'une lettre majuscule est différente de sa valeur minuscule. Pour faire des recherches insensible à la casse, utilisez la fonction FN_findreplacei(). 

Rappel : La fonction FN_findreplace() 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_findreplace() 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_findreplace( ktest$ , "A" , "B" , 0 )

PRINT "Valeur modifiee : " ; ktest$

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