{"id":5675,"date":"2016-08-31T07:24:52","date_gmt":"2016-08-31T07:24:52","guid":{"rendered":"http:\/\/anthroponaute.fr\/blog-informatique\/?p=5675"},"modified":"2024-02-21T09:50:54","modified_gmt":"2024-02-21T09:50:54","slug":"apprendre-a-utiliser-tinyxml-pour-charger-vos-fichiers-xml","status":"publish","type":"post","link":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/?p=5675","title":{"rendered":"Apprendre \u00e0 utiliser TinyXML pour charger vos fichiers XML"},"content":{"rendered":"

\"tinyxml\"<\/a><\/p>\n

Intro :<\/strong><\/p>\n

Parfois dans un programme ou un jeu vid\u00e9o, il est n\u00e9cessaire de charger des donn\u00e9es<\/strong> sous format XML<\/strong>. Par exemple pour un \u00e9diteur de sc\u00e8ne<\/strong> \/ monde, on peut vouloir charger les positions<\/strong> des entit\u00e9s directement depuis un fichier Scene.xml<\/em> par exemple.<\/p>\n

Pr\u00e9requis :<\/strong><\/p>\n

– Savoir lire du C++<\/em><\/p>\n

– Savoir lire un fichier XML<\/em><\/p>\n

– Savoir importer des fichiers sources<\/em> dans Visual C++<\/p>\n

Explications :<\/strong><\/p>\n

TinyXML est une toute petite librairie<\/strong> C++ permettant de charger et d’analyser les donn\u00e9es stock\u00e9es dans un fichier XML<\/strong>. Elle est sous la licence Zlib (cela signifie que vous pouvez l’utiliser pour n’importe quoi !)<\/p>\n

D’abord il vous faut t\u00e9l\u00e9charger les sources<\/strong> de TinyXML. La derni\u00e8re version \u00e0 la date d’\u00e9criture de cet article est la version 2.<\/p>\n

Deux choix s’offrent \u00e0 vous : soit d’utiliser la version 1<\/em> ; soit d’utiliser la version 2<\/em>.<\/p>\n

Les avantages de choisir la 2\u00e8me : meilleur gestion de la m\u00e9moire ; lecture plus rapide du fichier XML ; pas d’utilisation de la STL.<\/p>\n

TinyXML charge compl\u00e8tement un fichier XML avec la m\u00e9thode LoadFile()<\/strong>… Il vous reste ensuite le soin d’analyser votre fichier XML en fonction de son contenu<\/strong> en terme de n\u0153uds<\/em>.<\/p>\n

On pr\u00e9cise que XML est l’abr\u00e9viation de \u00ab\u00a0eX<\/strong>tensible M<\/strong>arkup L<\/strong>anguage\u00a0\u00bb. XML est un format pour stocker des donn\u00e9es<\/strong>, pas un langage de programmation !
\nCelles-ci sont \u00e9crites entre des balises ou sous forme d’attributs, et l’ensemble est \u00e9crit sous forme d’un arbre.<\/p>\n

Voici la structure<\/strong> d’un fichier XML :<\/p>\n

\r\n&lt;?xml version=&quot;1.0&quot; ?&gt;\r\n&lt;root&gt;\r\n\u00a0\u00a0\u00a0 &lt;UnElement attribut1 =&quot;une valeur&quot; \/&gt;\r\n\u00a0\u00a0\u00a0 &lt;UnAutreElement attribut2 = &quot;2&quot; attribute3 = &quot;3&quot;&gt;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &lt;Element3 attribut4=&quot;4&quot; \/&gt;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Du Texte !\r\n\u00a0\u00a0\u00a0 &lt;\/UnAutreElement&gt;\r\n&lt;\/root&gt;\r\n<\/pre>\n
 <\/p>\n
Il vous faut importer<\/strong> dans votre projet Visual C++ la librairie directement par l’interm\u00e9diaire de ces fichiers :<\/p>\n
– tinystr.cpp<\/strong>
\n – tinyxmlerror.cpp<\/strong>
\n – tinystr.h<\/strong>
\n – tinyxml.h<\/strong>
\n – tinyxml.cpp<\/strong>
\n – tinyxmlparser.cpp<\/strong><\/p>\n
 <\/p>\n
Dans votre fichier source .cpp utilisant TinyXML, il vous faudra \u00e9crire #include \u00ab\u00a0tinyxml.h\u00a0\u00bb en tant que fichier d’en-t\u00eate !<\/p>\n
Vous pouvez d\u00e9finir le define #define TIXML_USE_STL<\/strong> pour activer <\/strong>l’utilisation de la STL<\/strong> dans TinyXml.<\/p>\n
Sachez que TinyXML reconna\u00eet<\/strong> automatiquement l’encodage<\/strong> utilis\u00e9 par le fichier \u00e0 charger (il n’est pas n\u00e9cessaire de renseigner l’attribut \u00ab\u00a0encoding\u00a0\u00bb).<\/p>\n
Commen\u00e7ons l’analyse d’un fichier quelconque :<\/p>\n
\r\nTiXmlDocument doc;\r\nif(!doc.LoadFile(&quot;Test.xml&quot;))\r\n{\r\n\u00a0\u00a0\u00a0 std::cerr &lt;&lt; doc.ErrorDesc() &lt;&lt; std::endl;\r\n\u00a0\u00a0\u00a0 return FAILURE;\r\n}\r\n<\/pre>\n
 <\/p>\n
Le fichier \u00ab\u00a0doc\u00a0\u00bb contient toutes les donn\u00e9es d’analyse du fichier XML charg\u00e9.<\/p>\n
\r\nTiXmlElement* pRoot = doc.FirstChildElement();\r\nif (pRoot == nullptr)\r\n{\r\n\u00a0\u00a0\u00a0 std::cerr &lt;&lt; &quot;Echec chargement du fichier. Aucun \u00e9l\u00e9ment racine.&quot; &lt;&lt; std::endl;\r\n\u00a0\u00a0\u00a0 doc.Clear();\r\n\r\n\u00a0\u00a0\u00a0 return FAILURE;\r\n}\r\n<\/pre>\n
 <\/p>\n
La m\u00e9thode FirstChildElement()<\/strong> renvoie un pointeur vers un objet TinyXmlElement<\/strong> qui repr\u00e9sente le premier n\u0153ud<\/em> du fichier XML en question. FirstChildElement()<\/strong> prend un param\u00e8tre une cha\u00eene de caract\u00e8res repr\u00e9sentant le nom du n\u0153ud en question.<\/p>\n
Une boucle permet d’afficher tout les noms des \u00e9l\u00e9ments du fichier :<\/p>\n
\r\nfor (TiXmlElement* pElem = pRoot-&gt;FirstChildElement(); pElem != nullptr; pElem = pElem-&gt;NextSiblingElement())\r\n{\r\n\u00a0\u00a0\u00a0 std::string elemName = pElem-&gt;Value();\r\n}\r\n<\/pre>\n
 <\/p>\n
Le principe est le suivant : on parcourt chaque n\u0153ud en extrayant de chaque<\/strong> n\u0153ud enfant les attributs qui nous int\u00e9ressent !<\/p>\n
\r\n...\r\n\r\n[...La boucle...]\r\n\r\n\u00a0\u00a0\u00a0 const char* attr = nullptr;\r\n\r\n\u00a0\u00a0\u00a0 if (elemName == &quot;UnElement&quot;)\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 attr = elem-&gt;Attribute(&quot;attribut1&quot;);\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (attr != nullptr)\r\n\u00a0\u00a0 \u00a0    {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0    \/\/ Faire le travail d'analyse ici\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }\r\n\u00a0\u00a0\u00a0 }\r\n\r\n[...Fin de boucle...]\r\n<\/pre>\n
 <\/p>\n
La variable attr<\/em> <\/strong>repr\u00e9sente la valeur de l’attribut<\/strong> en question. Si l’attribut ne comporte pas le nom sp\u00e9cifi\u00e9. La m\u00e9thode Attribute(…)<\/strong> renvoie nullptr.<\/p>\n
On peut tester si le contenu d’un n\u0153ud est du texte avec la m\u00e9thode elem->ToText()<\/em><\/strong>. Elle renvoie nullptr<\/strong> s’il n’y a pas de texte.<\/p>\n
Il peut \u00eatre utile d’utiliser une structure de donn\u00e9es sp\u00e9cifique customis\u00e9e afin de stocker les donn\u00e9es lues depuis le fichier XML. Mais cela reste facultatif !<\/p>\n
On fini l’analyse avec l’appel de Clear() : doc.Clear();<\/p>\n
Pour faciliter le parcours des n\u0153uds, on peut utiliser ce qu’on appelle des handles<\/strong><\/em>.
\nExemple :<\/p>\n
\r\nTiXmlHandle hdl(&amp;doc);\r\nTiXmlElement *elem = hdl.FirstChildElement().FirstChildElement().Element();\r\n<\/pre>\n
 <\/p>\n
La m\u00e9thode QueryIntAttribute(…)<\/strong> permet d’obtenir la valeur d’un attribut sous forme de integer<\/p>\n
Voici la liste des classes de TinyXML format\u00e9e par Doxygen<\/em> : http:\/\/www.grinninglizard.com\/tinyxmldocs\/annotated.html<\/p>\n
R\u00e9sum\u00e9 :<\/strong><\/p>\n
Simple<\/strong> et efficace<\/strong>, la petite librairie TinyXML<\/em> facilitera vos chargement de donn\u00e9es sous format XML.<\/p>\n
R\u00e9f\u00e9rences :<\/strong><\/p>\n
– http:\/\/www.dinomage.com\/2012\/01\/tutorial-using-tinyxml-part-1\/<\/p>\n","protected":false},"excerpt":{"rendered":"
Intro : Parfois dans un programme ou un jeu vid\u00e9o, il est n\u00e9cessaire de charger des donn\u00e9es sous format XML. Par exemple pour un \u00e9diteur de sc\u00e8ne \/ monde, on peut vouloir charger les positions des entit\u00e9s directement depuis un fichier Scene.xml par exemple. Pr\u00e9requis : – Savoir lire du C++ – Savoir lire un […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[19],"tags":[],"_links":{"self":[{"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/posts\/5675"}],"collection":[{"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=5675"}],"version-history":[{"count":24,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/posts\/5675\/revisions"}],"predecessor-version":[{"id":5974,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=\/wp\/v2\/posts\/5675\/revisions\/5974"}],"wp:attachment":[{"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=5675"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=5675"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.la-porte-des-nebuleuses.net\/blog-informatique\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=5675"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}