ParsingFlags

Parse flag instructing the parser to not create data nodes. Text of first data node will still be placed in value of parent element, unless EelementValues flag is also specified. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to not use text of first data node as a value of parent element. Can be combined with other flags by use of | operator. Note that child data nodes of element node take precendence over its value when printing. That is, if element has one or more child data nodes <em>and</em> a value, the value will be ignored. Use DataNodes flag to prevent creation of data nodes if you want to manipulate data using values of elements. <br><br>

Parse flag instructing the parser to not place zero terminators after strings in the source text. By default zero terminators are placed, modifying source text. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to not translate entities in the source text. By default entities are translated, modifying source text. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to disable UTF-8 handling and assume plain 8 bit characters. By default, UTF-8 handling is enabled. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to create XML declaration node. By default, declaration node is not created. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to create comments nodes. By default, comment nodes are not created. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to create DOCTYPE node. By default, doctype node is not created. Although W3C specification allows at most one DOCTYPE node, RapidXml will silently accept documents with more than one. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to create PI nodes. By default, PI nodes are not created. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to validate closing tag names. If not set, name inside closing tag is irrelevant to the parser. By default, closing tags are not validated. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to trim all leading and trailing whitespace of data nodes. By default, whitespace is not trimmed. This flag does not cause the parser to modify source text. Can be combined with other flags by use of | operator. <br><br>

Parse flag instructing the parser to condense all whitespace runs of data nodes to a single space character. Trimming of leading and trailing whitespace of data is controlled by TrimWhitespace flag. By default, whitespace is not normalized. If this flag is specified, source text will be modified. Can be combined with other flags by use of | operator. <br><br>

Parse flag to say "Parse only the initial element opening." Useful for XMLstreams used in XMPP.

Parse flag to say "Toss the children of the top node and parse off one element. Useful for parsing off XMPP top-level elements.

Parse flag to say "Validate XML namespaces fully." This will generate additional errors, including unbound prefixes and duplicate attributes (with different prefices)

Parse flags which represent default behaviour of the parser. This is always equal to 0, so that all other flags can be simply ored together. Normally there is no need to inconveniently disable flags by anding with their negated (~) values. This also means that meaning of each flag is a <i>negation</i> of the default setting. For example, if flag name is NoUtf8, it means that utf-8 is <i>enabled</i> by default, and using the flag will disable it. <br><br>

A combination of parse flags that forbids any modifications of the source text. This also results in faster parsing. However, note that the following will occur: <ul> <li>names and values of nodes will not be zero terminated, you have to use xml_base::name_size() and xml_base::value_size() functions to determine where name and value ends</li> <li>entities will not be translated</li> <li>whitespace will not be normalized</li> </ul>

A combination of parse flags resulting in fastest possible parsing, without sacrificing important data. <br><br>

A combination of parse flags resulting in largest amount of data being extracted. This usually results in slowest parsing. <br><br>