@XMLPUTATTR[name,namespaceURI,value] : Écrit un attribut XML

 

@XMLPUTATTR écrit un attribut XML sur l'élément XML actuellement ouvert. Il doit être appelé juste après l'appel à @XMLSTARTELEMENT et avant tout appel à @XMLPUTSTRING, @XMLPUTCOMMENT ou @XMLPUTRAW. Le fichier doit avoir été ouvert avec un @XMLOPEN précédent.

 

Si name est un nom local sans préfixe, la classe introduira automatiquement un nouvel attribut xmlns="NamespaceURI" si nécessaire.

Si  le nom est sous la forme prefix:local, la classe introduira automatiquement un nouvel attribut xmlns:prefix="NamespaceURI" si nécessaire.

Certains noms d'attributs sont traités de manière particulière par cette méthode. Si le nom est "xmlns" ou utilise le préfixe "xmlns", l'attribut sera interprété comme une déclaration d'espace de noms, quelle que soit la valeur de NamespaceURI.  De même, tout attribut utilisant le préfixe "xml" sera interprété comme un attribut spécial (comme "xml:lang") et NamespaceURI sera ignoré.

Renvoie 0 en cas de succès, ou une erreur XML en cas d'échec.

 

Exemple :

 

Pour créer un fichier XML nommé books.xml:

 

<book xmlns='urn:loc.gov:books' xmlns:isbn='urn:ISBN:0-395-36341-6'>

<title>Cheaper by the Dozen</title>

<isbn:number>1568491379</isbn:number>

</book>

 

Utilisez le code :

 

echo %@xmlcreate[books.xml]

echo %@xmlstartelement[book,urn:loc.gov:books]

echo %@xmlputattr[xmlns:isbn,"",urn:ISBN:0-395-36341-6]

echo %@xmlputelement[title,urn:loc.gov:books,Cheaper by the Dozen]

echo %@xmlputelement[isbn:number,urn:ISBN:0-395-36341-6,1568491379);

echo %@xmlendelement[]

echo %@xmlclose[]

 

Erreurs XML :

 

101 Index d'attribut non valide

102 Aucun attribut disponible

103 Index d'espace de noms incorrect

104 Aucun espace de noms disponible

105 Index d'élément incorrect

106 Aucun élément disponible

107 L'attribut n'existe pas

201 Balise d'élément déséquilibrée

202 Préfixe d'élément inconnu (espace de noms introuvable)

203 Préfixe d'attribut inconnu (espace de noms introuvable)

204 Balisage XML non valide

205 État final invalide pour l'analyseur

206 Le document contient des éléments déséquilibrés

207 XPath invalide

208 Aucun enfant de ce type

209 L'élément supérieur ne correspond pas au début du chemin

210 L'arbre DOM n'est pas disponible

302 Impossible d'ouvrir le fichier

401 Un XML invalide serait généré

402 Un nom XML non valide a été spécifié