XMLparser

C++17 Based Single-header C++ XML Parser.

Copyright © 2022 JH Strom

+ This project is free and open source software (FOSS)

About

This library will parse nearly any valid XML formatted file, including file types like .dae which use XML formatting. This parser requires either a node with an 'xml' tag with the 'encoding' attribute or a BOM with the appropriate encoding bits to parse correctly, else it is assumed all XML files are formatted as ASCII chars/plaintext. Development is ongoing to accurately parse all encodings for .xml files, but generally all UTF-8 or UTF-16 files should be parseable. There are no external dependencies other than C/C++ STL or standard library headers.

Usage Examples

load/save a file:

XMLparser xml;                                        // Create instance of the parser object to hold nodes, etc.  
xml.load("local_file.xml");                           // Load a file to a linear list of nodes with child/parent pointers to preserve XML tree structure. 
if(!xml.validate())                                   // Check loaded xml nodes to see if the results are valid.
  return;
int idx = xml.getIndexByTagFirstOrDefault("data");    // Get the index of a particular node by type.  
XMLnode open_node(L"<test_val id="2">");              // Create an scoped 'open' node with tag 'test_val'.  
XMLnode close_node(L"</test_val>"));                  // Create a closing node to match the open 'test_val' node to close this scope.  
xml.nodes.insert(xml.nodes.begin() + idx, open_node); // Insert both nodes into the linear node list.  
xml.nodes.insert(xml.nodes.begin() + idx + 1, close_node);  
xml.save("local_file.xml");                           // Write file to disk, overwriting the local_file.xml file's contents by default.  

Supported

XML versions: 1.0, 1.1
Encodings: ASCII/plaintext, UTF-8, UTF-16
Platforms: Windows

Upcoming Features

• Support for various encodings and formats
• Beautification/Uglification
• XML Compression/Decompression

Notes

This code has been tested on a Windows 10 machine and compiled with MSVC (and also some rudimentary compilation tests with GCC thanks to cpp.sh) with C++11, C++14, C++17, and C++20 compilers with all Wall/pedantic options. For questions about formatting, see the W3 XML standard doc. If you are having trouble parsing a particular XML file, please create an issue on this repo. Thank you for your patience.

• Microsoft's list of valid XML encodings: https://docs.microsoft.com/en-us/previous-versions/troubleshoot/msxml/xml-encoding-dom-interface-methods