ADELIA |
VADELIA |
SADELIA |
WADELIA |
MADELIA |
(I/B) |
(I/B) (C/S) |
(B) (S) |
(I/B) (C/S) |
(I) (C/S) |
Paragraphe d'utilisation
Tous.
Syntaxe
XML_CREER_NOEUD NomIdentifiantXml TypeNoeud NomDuNoeud UtilisationNS DéclarationNS
TypeNoeud |
→ |
*FILS|*FRERE |
NomDuNoeud |
→ |
<cste alpha> | <variable alpha> |
UtilisationNS |
→ |
*NS(Préfixe) | Rien |
DéclarationNS |
→ |
*DECL_NS(SuitePréfixeNamespaceAvecDéfaut) | Rien |
SuitePréfixeNamespaceAvecDéfaut |
→ |
SuitePréfixeNamespaceAvecDéfaut, Préfixe Défaut | Préfixe Défaut |
Préfixe |
→ |
<constante alpha> |
Défaut |
→ |
*DFT | Rien |
Description
Crée, à partir du noeud courant, un noeud fils ou frère. Le noeud créé est le nouveau noeud courant.
*NS permet d'affecter à un nœud un espace de nom (=namespace). Le nom du nœud est préfixé par le préfixe associé à l'espace de nom, sauf si le préfixe correspond à l'espace de nom par défaut.
*DECL_NS permet de forcer la déclaration sur le nœud d'un (ou des) espace(s) de nom (=namespace). Ces espaces de nom doivent avoir été définis auparavant via l'instruction XML_AJOUTER_NS. *DFT permet d'indiquer que c'est l'espace de nom par défaut.
L'option *DFT ne peut être utilisée qu'une seule fois.
Après l'exécution de cet ordre, le mot réservé *CODE_RETOUR peut prendre les valeurs suivantes :
0 (*NORMAL) |
L'opération s'est bien déroulée. |
5 |
Erreur lors de la création du noeud. |
7 |
Erreur lors de la création du noeud racine. |
13 |
Erreur : l'identifiant XML n'est pas ouvert. |
27 |
Erreur : préfixe utilisé dans *DECL_NS ne correspond à aucun espace de nom défini par XML_AJOUTER_NS |
Par exemple
XML_CREER_NOEUD xml1 *FILS 'racine'
XML_CREER_NOEUD xml1 *FILS 'PremierFilsRacine'
XML_CREER_VAL xml1 'texte du 1er PremierFilsRacine'
XML_CREER_NOEUD xml1 *FRERE 'PremierFilsRacine'
XML_CREER_VAL xml1 'texte du 2e PremierFilsRacine'
XML_SELECTION xml1 ..
XML_CREER_NOEUD xml1 *FILS 'DeuxiemeFilsRacine'
XML_CREER_VAL xml1 'texte du 1er DeuxiemeFilsRacine'
Exemples avec *NS et *DECL_NS :
Les trois exemples d'utilisation de XML_CREER_NOEUD ci-dessous fonctionnent normalement si les espaces de nom liés aux préfixes 'typ' et 'xro' ont bien été définis via les ordres XML_AJOUTER_NS suivants :
XML_AJOUTER_NS MonXml 'typ' 'http://types.hardis.com'
XML_AJOUTER_NS MonXml 'xro' 'http://xroutes.hardis.com'
XML_CREER_NOEUD MonXml *FILS 'nomNoeud' *DECL_NS ('typ' , 'xro')
→ |
<nomNoeud xmlns:typ="http://types.hardis.com" xmlns:xro="http://xroute.hardis.com"> |
XML_CREER_NOEUD MonXml *FILS 'nomNoeud' *NS('typ')
→ |
<typ:nomNoeud> |
XML_CREER_NOEUD MonXml *FILS 'nomNoeud' *NS('typ') *DECL_NS('typ' *DFT)
→ |
<nomNoeud xmlns="http://types.hardis.com"> |