XML_CREER_NOEUD

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')