DESCRIPTION.

La fonction FN_repEnt() remplace, dans une chaine de cractères, les entités XML, c'est-à-dire certaines combinaisons de symboles, par les caractères correspondants.

SYNTAXE.

ksymbole$ = FN_repEnt( variable )

REMARQUES

variable doit être l'identifiant d'une variable de type $. variable sera analysé, modifié si necessaire puis retourné. C'est pour cela qui est obligatoire que variable soit une variable exixtante et valide.

L'appel de la fonction FN_repEnt() retourne le symbole de remplacement (<, > , ", "" ou &) ainsi que variable modifié.

Les références d'entités sont des représentations spéciales de caractères qui ont une signification particulière en XML, 

- la combinaison &lt; sera remplacée par le symbole < ;

- la combinaison &gt; sera remplacée par le symbole > ;

- la combinaison &apos; sera remplacée par le symbole " (guillemet) ;

- la combinaison &quot; sera remplacée par le symbole "" (double guillemet) ;

- la combinaison &amp; sera remplacée par le symbole &.

Voir l'instruction DIM{} pour plus de détails sur les structures de données.

Rappel : La procédure PROC_initXML() doit toujours être appelée avant toute autre procédure ou fonction définie dans le module xmllib.bbc.

La procédure FN_repEnt() est importée depuis le module xmllib.bbc.

EXEMPLE.

INSTALL @lib$ + "xmllib.bbc"

PROC_initXML( XML_donnees{} , "monfichier.xml" )

DIM LST_Entites$( 4 ) : LST_Entites$() = "&lt;" , "&gt;" , "&apos;" , "&quot;", "&amp;"

FOR kindex = 0 TO 4

kentite$ = LST_Entites$( kindex ) 

PRINT "L'entite " ; kentite$ ; " sera convertie en " ; FN_repEnt( kentite$ )

NEXT kindex

PROC_exitXML( XML_donnees{} )

END