Modifying document data

+ Working with text contents +

+ pugixml provides a special class, xml_text, + to work with text contents stored as a value of some node, i.e. <node><description>This is a node</description></node>. + Working with text objects to retrieve data is described in the + documentation for accessing document data; this section describes + the modification interface of xml_text. +

+ Once you have an xml_text + object, you can set the text contents using the following function: +

bool xml_text::set(const char_t* rhs);
+

+ This function tries to set the contents to the specified string, and returns + the operation result. The operation fails if the text object was retrieved + from a node that can not have a value and that is not an element node (i.e. + it is a node_declaration node), if + the text object is empty, or if there is insufficient memory to handle the + request. The provided string is copied into document managed memory and can + be destroyed after the function returns (for example, you can safely pass + stack-allocated buffers to this function). Note that if the text object was + retrieved from an element node, this function creates the PCDATA child node + if necessary (i.e. if the element node does not have a PCDATA/CDATA child + already). +

+ In addition to a string function, several functions are provided for handling + text with numbers and booleans as contents: +

bool xml_text::set(int rhs);
+bool xml_text::set(unsigned int rhs);
+bool xml_text::set(double rhs);
+bool xml_text::set(bool rhs);
+

+ The above functions convert the argument to string and then call the base + set function. These functions + have the same semantics as similar xml_attribute + functions. You can refer to documentation + for the attribute functions for details. +

+ For convenience, all set + functions have the corresponding assignment operators: +

xml_text& xml_text::operator=(const char_t* rhs);
+xml_text& xml_text::operator=(int rhs);
+xml_text& xml_text::operator=(unsigned int rhs);
+xml_text& xml_text::operator=(double rhs);
+xml_text& xml_text::operator=(bool rhs);
+

+ These operators simply call the right set + function and return the attribute they're called on; the return value of + set is ignored, so errors + are ignored. +

+ This is an example of using xml_text + object to modify text contents (samples/text.cpp): +

+ +

// change project version
+project.child("version").text() = 1.2;
+
+// add description element and set the contents
+// note that we do not have to explicitly add the node_pcdata child
+project.append_child("description").text().set("a test project");
+

+ Working with text contents +

Cloning nodes/attributes