Public Member Functions | Static Protected Member Functions | Protected Attributes | List of all members
rapidxml::xml_base< Ch > Class Template Reference

#include <rapidxml.hpp>

Inheritance diagram for rapidxml::xml_base< Ch >:
Inheritance graph
[legend]

Public Member Functions

Ch * name () const
 
void name (const Ch *name, std::size_t size)
 
void name (const Ch *name)
 
std::size_t name_size () const
 
xml_node< Ch > * parent () const
 
Ch * value () const
 
void value (const Ch *value, std::size_t size)
 
void value (const Ch *value)
 
std::size_t value_size () const
 
 xml_base ()
 

Static Protected Member Functions

static Ch * nullstr ()
 

Protected Attributes

Ch * m_name
 
std::size_t m_name_size
 
xml_node< Ch > * m_parent
 
Ch * m_value
 
std::size_t m_value_size
 

Detailed Description

template<class Ch = char>
class rapidxml::xml_base< Ch >

Base class for xml_node and xml_attribute implementing common functions: name(), name_size(), value(), value_size() and parent().

Parameters
ChCharacter type to use

Definition at line 648 of file rapidxml.hpp.

Constructor & Destructor Documentation

template<class Ch = char>
rapidxml::xml_base< Ch >::xml_base ( )
inline

Definition at line 657 of file rapidxml.hpp.

Member Function Documentation

template<class Ch = char>
Ch* rapidxml::xml_base< Ch >::name ( ) const
inline

Gets name of the node. Interpretation of name depends on type of node. Note that name will not be zero-terminated if rapidxml::parse_no_string_terminators option was selected during parse.

Use name_size() function to determine length of the name.

Returns
Name of node, or empty string if node has no name.

Definition at line 673 of file rapidxml.hpp.

template<class Ch = char>
void rapidxml::xml_base< Ch >::name ( const Ch *  name,
std::size_t  size 
)
inline

Sets name of node to a non zero-terminated string. See ownership_of_strings.

Note that node does not own its name or value, it only stores a pointer to it. It will not delete or otherwise free the pointer on destruction. It is reponsibility of the user to properly manage lifetime of the string. The easiest way to achieve it is to use memory_pool of the document to allocate the string - on destruction of the document the string will be automatically freed.

Size of name must be specified separately, because name does not have to be zero terminated. Use name(const Ch *) function to have the length automatically calculated (string must be zero terminated).

Parameters
nameName of node to set. Does not have to be zero terminated.
sizeSize of name, in characters. This does not include zero terminator, if one is present.

Definition at line 721 of file rapidxml.hpp.

template<class Ch = char>
void rapidxml::xml_base< Ch >::name ( const Ch *  name)
inline

Sets name of node to a zero-terminated string. See also ownership_of_strings and xml_node::name(const Ch *, std::size_t).

Parameters
nameName of node to set. Must be zero terminated.

Definition at line 730 of file rapidxml.hpp.

template<class Ch = char>
std::size_t rapidxml::xml_base< Ch >::name_size ( ) const
inline

Gets size of node name, not including terminator character. This function works correctly irrespective of whether name is or is not zero terminated.

Returns
Size of node name, in characters.

Definition at line 681 of file rapidxml.hpp.

template<class Ch = char>
static Ch* rapidxml::xml_base< Ch >::nullstr ( )
inlinestaticprotected

Definition at line 778 of file rapidxml.hpp.

template<class Ch = char>
xml_node<Ch>* rapidxml::xml_base< Ch >::parent ( ) const
inline

Gets node parent.

Returns
Pointer to parent node, or 0 if there is no parent.

Definition at line 770 of file rapidxml.hpp.

template<class Ch = char>
Ch* rapidxml::xml_base< Ch >::value ( void  ) const
inline

Gets value of node. Interpretation of value depends on type of node. Note that value will not be zero-terminated if rapidxml::parse_no_string_terminators option was selected during parse.

Use value_size() function to determine length of the value.

Returns
Value of node, or empty string if node has no value.

Definition at line 692 of file rapidxml.hpp.

template<class Ch = char>
void rapidxml::xml_base< Ch >::value ( const Ch *  value,
std::size_t  size 
)
inline

Sets value of node to a non zero-terminated string. See ownership_of_strings.

Note that node does not own its name or value, it only stores a pointer to it. It will not delete or otherwise free the pointer on destruction. It is reponsibility of the user to properly manage lifetime of the string. The easiest way to achieve it is to use memory_pool of the document to allocate the string - on destruction of the document the string will be automatically freed.

Size of value must be specified separately, because it does not have to be zero terminated. Use value(const Ch *) function to have the length automatically calculated (string must be zero terminated).

If an element has a child node of type node_data, it will take precedence over element value when printing. If you want to manipulate data of elements using values, use parser flag rapidxml::parse_no_data_nodes to prevent creation of data nodes by the parser.

Parameters
valuevalue of node to set. Does not have to be zero terminated.
sizeSize of value, in characters. This does not include zero terminator, if one is present.

Definition at line 751 of file rapidxml.hpp.

template<class Ch = char>
void rapidxml::xml_base< Ch >::value ( const Ch *  value)
inline

Sets value of node to a zero-terminated string. See also ownership_of_strings and xml_node::value(const Ch *, std::size_t).

Parameters
valueVame of node to set. Must be zero terminated.

Definition at line 760 of file rapidxml.hpp.

template<class Ch = char>
std::size_t rapidxml::xml_base< Ch >::value_size ( ) const
inline

Gets size of node value, not including terminator character. This function works correctly irrespective of whether value is or is not zero terminated.

Returns
Size of node value, in characters.

Definition at line 700 of file rapidxml.hpp.

Member Data Documentation

template<class Ch = char>
Ch* rapidxml::xml_base< Ch >::m_name
protected

Definition at line 784 of file rapidxml.hpp.

template<class Ch = char>
std::size_t rapidxml::xml_base< Ch >::m_name_size
protected

Definition at line 786 of file rapidxml.hpp.

template<class Ch = char>
xml_node<Ch>* rapidxml::xml_base< Ch >::m_parent
protected

Definition at line 788 of file rapidxml.hpp.

template<class Ch = char>
Ch* rapidxml::xml_base< Ch >::m_value
protected

Definition at line 785 of file rapidxml.hpp.

template<class Ch = char>
std::size_t rapidxml::xml_base< Ch >::m_value_size
protected

Definition at line 787 of file rapidxml.hpp.


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


mvsim
Author(s):
autogenerated on Fri May 7 2021 03:05:52