XmlElement Class Reference

Class representing a node in an XML document. More...

#include "libxml_wrapper.h"

Public Member Functions
	XmlElement (const xmlNode *node)
	Constructor for XmlElement.
	XmlElement (const XmlElement &)=default
	XmlElement (XmlElement &&) noexcept=default
XmlElement &	operator= (const XmlElement &)=default
XmlElement &	operator= (XmlElement &&) noexcept=default
	~XmlElement ()=default
std::string_view	name () const noexcept
	Get the name of the XML element.
std::string	getText () const
	Get the text content of the XML element.
void	setText (const std::string_view text) const
	Set the text content of the XML element.
void	setAttribute (const std::string_view name, const std::string_view value) const
	Set an attribute on the XML element.
XmlElement	addChild (const std::string_view name) const noexcept
	Add a child element to the current node.
XmlElement	childElement (const std::string_view name="", const unsigned index=0) const noexcept
	Retrieve a child element by name and index.
bool	isValid () const noexcept
	Check if the XML element is valid.
xmlNodePtr	getNode () const noexcept
	Get the underlying XML node pointer.

Static Public Member Functions
static std::string	getSafeAttribute (const XmlElement &element, const std::string_view name)
	Get the value of an attribute safely.
static std::optional< std::string >	getOptionalAttribute (const XmlElement &element, const std::string_view name)
	Get the value of an optional attribute.

Detailed Description

Class representing a node in an XML document.

This class encapsulates an XML element, allowing users to access and manipulate element names, attributes, content, and children. It uses libxml2 for all operations and provides simplified methods to interact with XML nodes.

Definition at line 54 of file libxml_wrapper.h.

Constructor & Destructor Documentation

XmlElement() [1/3]

XmlElement::XmlElement ( const xmlNode *  node )

explicit

Constructor for XmlElement.

Parameters

node	The xmlNode pointer representing the XML element.

Definition at line 64 of file libxml_wrapper.h.

: _node(const_cast<xmlNode*>(node)) {}

XmlElement() [2/3]

XmlElement::XmlElement ( const XmlElement &  )

default

XmlElement() [3/3]

XmlElement::XmlElement ( XmlElement &&  )

defaultnoexcept

~XmlElement()

XmlElement::~XmlElement ( )

default

Member Function Documentation

addChild()

XmlElement XmlElement::addChild ( const std::string_view  name ) const

noexcept

Add a child element to the current node.

Parameters

name	The name of the new child element.

Returns

The newly created XmlElement.

Definition at line 173 of file libxml_wrapper.h.

    {
        const xmlNode* child = xmlNewNode(nullptr, reinterpret_cast<const xmlChar*>(name.data()));
        xmlAddChild(_node, const_cast<xmlNode*>(child));
        return XmlElement(child);
    }

References name().

Referenced by serial::xml_serializer_utils::addChildWithText(), serial::xml_serializer_utils::serializeMonostatic(), serial::xml_serializer_utils::serializeMotionPath(), serial::xml_serializer_utils::serializeParameters(), serial::xml_serializer_utils::serializePlatform(), serial::xml_serializer_utils::serializeReceiver(), serial::xml_serializer_utils::serializeRotation(), serial::xml_serializer_utils::serializeSchedule(), serial::xml_serializer_utils::serializeTarget(), serial::xml_serializer_utils::serializeTiming(), serial::xml_serializer_utils::serializeTransmitter(), serial::xml_serializer_utils::serializeWaveform(), and serial::world_to_xml_string().

Here is the call graph for this function:

Here is the caller graph for this function:

childElement()

XmlElement XmlElement::childElement ( const std::string_view  name = "", const unsigned  index = 0  ) const

noexcept

Retrieve a child element by name and index.

Parameters

name	The name of the child element (optional).
index	The index of the child to retrieve.

Returns

The child element or an invalid XmlElement if not found.

Definition at line 187 of file libxml_wrapper.h.

    {
        if (_node == nullptr)
        {
            return XmlElement(nullptr);
        }
        unsigned count = 0;
        for (auto* child = _node->children; child != nullptr; child = child->next)
        {
            if (child->type == XML_ELEMENT_NODE && (name.empty() || name == reinterpret_cast<const char*>(child->name)))
            {
                if (count == index)
                {
                    return XmlElement(child);
                }
                ++count;
            }
        }
        return XmlElement(nullptr);
    }

References name().

Referenced by serial::xml_parser_utils::collectIncludeElements(), radar::FileTarget::FileTarget(), serial::xml_parser_utils::get_child_real_type(), serial::xml_parser_utils::parseMotionPath(), serial::xml_parser_utils::parseParameters(), serial::xml_parser_utils::parsePlatform(), serial::xml_parser_utils::parsePlatformElements(), serial::xml_parser_utils::parseReceiver(), serial::xml_parser_utils::parseRotationPath(), serial::xml_parser_utils::parseSchedule(), serial::xml_parser_utils::parseTarget(), serial::xml_parser_utils::parseTransmitter(), serial::xml_parser_utils::parseWaveform(), serial::xml_parser_utils::processParsedDocument(), and removeIncludeElements().

Here is the call graph for this function:

Here is the caller graph for this function:

getNode()

xmlNodePtr XmlElement::getNode ( ) const

noexcept

Get the underlying XML node pointer.

Returns

The underlying XML node pointer.

Definition at line 220 of file libxml_wrapper.h.

{ return _node; }

Referenced by getOptionalAttribute(), getSafeAttribute(), mergeXmlDocuments(), and XmlDocument::setRootElement().

Here is the caller graph for this function:

getOptionalAttribute()

static std::optional< std::string > XmlElement::getOptionalAttribute ( const XmlElement &  element, const std::string_view  name  )

static

Get the value of an optional attribute.

Parameters

element	The XmlElement to retrieve the attribute from.
name	The name of the attribute.

Returns

The attribute value if present.

Definition at line 140 of file libxml_wrapper.h.

    {
        if (!element.isValid())
        {
            return std::nullopt;
        }
        if (xmlChar* attr = xmlGetProp(element.getNode(), reinterpret_cast<const xmlChar*>(name.data())))
        {
            std::string value = reinterpret_cast<const char*>(attr);
            xmlFree(attr);
            return value;
        }
        return std::nullopt;
    }

References getNode(), isValid(), and name().

Here is the call graph for this function:

getSafeAttribute()

static std::string XmlElement::getSafeAttribute ( const XmlElement &  element, const std::string_view  name  )

static

Get the value of an attribute safely.

Parameters

element	The XmlElement to retrieve the attribute from.
name	The name of the attribute.

Returns

The value of the attribute.

Exceptions

XmlException

if the attribute is not found.

Definition at line 118 of file libxml_wrapper.h.

    {
        std::string value;
        if (xmlChar* attr = xmlGetProp(element.getNode(), reinterpret_cast<const xmlChar*>(name.data())))
        {
            value = reinterpret_cast<const char*>(attr);
            xmlFree(attr);
        }
        else
        {
            throw XmlException("Attribute not found: " + std::string(name));
        }
        return value;
    }

References getNode(), and name().

Referenced by serial::xml_parser_utils::get_attribute_bool(), serial::xml_parser_utils::parseAntenna(), serial::xml_parser_utils::parseMotionPath(), serial::xml_parser_utils::parseParameters(), serial::xml_parser_utils::parsePlatform(), serial::xml_parser_utils::parseReceiver(), serial::xml_parser_utils::parseRotationPath(), serial::xml_parser_utils::parseSchedule(), serial::xml_parser_utils::parseTarget(), serial::xml_parser_utils::parseTiming(), serial::xml_parser_utils::parseTransmitter(), serial::xml_parser_utils::parseWaveform(), serial::xml_parser_utils::processParsedDocument(), and serial::xml_parser_utils::resolve_reference_id().

Here is the call graph for this function:

Here is the caller graph for this function:

getText()

std::string XmlElement::getText

(

)

const

Get the text content of the XML element.

Returns

The text content as a string.

Definition at line 88 of file libxml_wrapper.h.

    {
        if (_node == nullptr)
        {
            return "";
        }
        xmlChar* text = xmlNodeGetContent(_node);
        std::string result = reinterpret_cast<const char*>(text);
        xmlFree(text);
        return result;
    }

Referenced by serial::xml_parser_utils::collectIncludeElements(), serial::xml_parser_utils::get_child_real_type(), and serial::xml_parser_utils::parseParameters().

Here is the caller graph for this function:

isValid()

bool XmlElement::isValid ( ) const

noexcept

Check if the XML element is valid.

Returns

True if the node is valid, otherwise false.

Definition at line 213 of file libxml_wrapper.h.

{ return _node != nullptr; }

Referenced by serial::xml_parser_utils::collectIncludeElements(), getOptionalAttribute(), serial::xml_parser_utils::parseMotionPath(), serial::xml_parser_utils::parseParameters(), serial::xml_parser_utils::parsePlatform(), serial::xml_parser_utils::parsePlatformElements(), serial::xml_parser_utils::parseReceiver(), serial::xml_parser_utils::parseRotationPath(), serial::xml_parser_utils::parseSchedule(), serial::xml_parser_utils::parseTarget(), serial::xml_parser_utils::parseTiming(), serial::xml_parser_utils::parseTransmitter(), serial::xml_parser_utils::parseWaveform(), and serial::xml_parser_utils::processParsedDocument().

Here is the caller graph for this function:

name()

std::string_view XmlElement::name ( ) const

noexcept

Get the name of the XML element.

Returns

The name of the XML element.

Definition at line 81 of file libxml_wrapper.h.

{ return reinterpret_cast<const char*>(_node->name); }

Referenced by addChild(), childElement(), getOptionalAttribute(), getSafeAttribute(), serial::xml_parser_utils::processParsedDocument(), and setAttribute().

Here is the caller graph for this function:

operator=() [1/2]

XmlElement & XmlElement::operator= ( const XmlElement &  )

default

operator=() [2/2]

XmlElement & XmlElement::operator= ( XmlElement &&  )

defaultnoexcept

setAttribute()

void XmlElement::setAttribute	(	const std::string_view	name,
		const std::string_view	value
	)		const

Set an attribute on the XML element.

Parameters

name	The name of the attribute.
value	The value to set for the attribute.

Definition at line 161 of file libxml_wrapper.h.

    {
        xmlSetProp(_node, reinterpret_cast<const xmlChar*>(name.data()),
                   reinterpret_cast<const xmlChar*>(value.data()));
    }

References name().

Referenced by serial::xml_serializer_utils::serializeAntenna(), serial::xml_serializer_utils::serializeMonostatic(), serial::xml_serializer_utils::serializeMotionPath(), serial::xml_serializer_utils::serializeParameters(), serial::xml_serializer_utils::serializePlatform(), serial::xml_serializer_utils::serializeReceiver(), serial::xml_serializer_utils::serializeRotation(), serial::xml_serializer_utils::serializeSchedule(), serial::xml_serializer_utils::serializeTarget(), serial::xml_serializer_utils::serializeTiming(), serial::xml_serializer_utils::serializeTransmitter(), serial::xml_serializer_utils::serializeWaveform(), serial::xml_serializer_utils::setAttributeFromBool(), and serial::world_to_xml_string().

Here is the call graph for this function:

Here is the caller graph for this function:

setText()

void XmlElement::setText

(

const std::string_view

text

)

const

Set the text content of the XML element.

Parameters

text	The text to set as the content of the node.

Definition at line 105 of file libxml_wrapper.h.

    {
        xmlNodeSetContent(_node, reinterpret_cast<const xmlChar*>(text.data()));
    }

Referenced by serial::xml_serializer_utils::addChildWithText().

Here is the caller graph for this function:

---

The documentation for this class was generated from the following file:

• packages/libfers/src/serial/libxml_wrapper.h