Project to improve and modernize the RapidXml 1.13 public API.
This project uses Semantic Versioning 2.0.0.
RapidXml is header-only. It is enough to make the headers visible to your building process to start using the library.
We support CMake. Just execute these commands from the root of the project:
cmake -E make_directory build
cmake -E chdir build cmake ..
And optionally install the library (commands for linux):
cd build
make install
- String view/ref support
- Policy type for case sensitivity
- Convenience
xml_document::parseoverload for constant XML strings. - Ranges of node children and attributes
Wherever a RapidXml 1.13 member function has const Ch* and std::size_t parameter pairs representing string spans, there is an overload taking std::basic_string_view<Ch> parameters, which passes to the overloaded member function the data() and size() values of the string views through the string spans' components they represent. [ Note: An empty string view can have non-nullptr data(). Some overloaded member functions interpret the non-nullptr const Ch* value of a string span with 0 std::size_t value as a gsl::czstring and attempt to calculate its size. To match this meaning of emptiness, when a string view is empty, nullptr is passed instead of its data() to those overloaded member functions. -- end note ]
The memory_pool::allocate_string overload returns a jegp::Basic_string_ref<Ch>.
For xml_base, the name_ref and value_ref member functions return a jegp::Basic_string_ref<Ch> constructed with the string span components returned from the name and name_size, and value and value_size member functions respectively.
To request or not case sensitive comparisons, the bool case_sensitive parameters of the overloads with string span support have been replaced with a dedicated type, case_sensitivity.
namespace rapidxml {
struct case_sensitivity { /*unspecified*/ };
// Requests that the comparisons are case sensitive (default).
constexpr case_sensitivity case_sensitive {/*unspecified*/};
// Requests that the comparisons are not case sensitive.
constexpr case_sensitivity non_case_sensitive {/*unspecified*/};
} // rapidxml namespaceThese constants can also be used in place of the bool case_sensitive parameters.
// In header <rapidxml_iterators.hpp>
//...
template<class Ch>
/*unspecified*/ node_range(const xml_node<Ch> *parent,
std::basic_string_view<Ch> name = {}) noexcept;
template<class Ch>
/*unspecified*/ attribute_range(const xml_node<Ch> *node,
std::basic_string_view<Ch> name = {}) noexcept;The functions return a range of pointers to the children/attributes of the node, optionally filtered by name.
The ranges offers minimal range-based for loop support.