From 75a0d2379aee05e59f0829b04240b9307469e727 Mon Sep 17 00:00:00 2001 From: "arseny.kapoulkine" Date: Tue, 25 May 2010 19:24:32 +0000 Subject: Updated version, updated changelog, minor Doxygen fixes git-svn-id: http://pugixml.googlecode.com/svn/trunk@449 99668b35-9821-0410-8761-19e4c4f06640 --- docs/html/classpugi_1_1xml__node.html | 427 ++++++++++++++++++++-------------- 1 file changed, 253 insertions(+), 174 deletions(-) (limited to 'docs/html/classpugi_1_1xml__node.html') diff --git a/docs/html/classpugi_1_1xml__node.html b/docs/html/classpugi_1_1xml__node.html index 833f4dc..25b2075 100644 --- a/docs/html/classpugi_1_1xml__node.html +++ b/docs/html/classpugi_1_1xml__node.html @@ -85,39 +85,39 @@ bool operator! () cons xml_node_type type () const  Get node type.
-const char * name () const +const char_t * name () const - Get node name (element name for element nodes, PI target for PI).
-const char * value () const + Get node name (element name for element nodes, PI target for PI).
+const char_t * value () const - Get node value (comment/PI/PCDATA/CDATA contents, depending on node type).
-xml_node child (const char *name) const + Get node value (comment/PI/PCDATA/CDATA contents, depending on node type).
+xml_node child (const char_t *name) const - Get child with the specified name.
-xml_node child_w (const char *name) const + Get child with the specified name.
+PUGIXML_DEPRECATED xml_node child_w (const char_t *name) const - Get child with the name that matches specified pattern.
-xml_attribute attribute (const char *name) const + Get child with the name that matches specified pattern.
+xml_attribute attribute (const char_t *name) const - Get attribute with the specified name.
-xml_attribute attribute_w (const char *name) const + Get attribute with the specified name.
+PUGIXML_DEPRECATED xml_attribute attribute_w (const char_t *name) const - Get attribute with the name that matches specified pattern.
-xml_node next_sibling (const char *name) const + Get attribute with the name that matches specified pattern.
+xml_node next_sibling (const char_t *name) const - Get first of following sibling nodes with the specified name.
-xml_node next_sibling_w (const char *name) const + Get first of following sibling nodes with the specified name.
+PUGIXML_DEPRECATED xml_node next_sibling_w (const char_t *name) const - Get first of the following sibling nodes with the name that matches specified pattern.
+ Get first of the following sibling nodes with the name that matches specified pattern.
xml_node next_sibling () const  Get following sibling.
-xml_node previous_sibling (const char *name) const +xml_node previous_sibling (const char_t *name) const - Get first of preceding sibling nodes with the specified name.
-xml_node previous_sibling_w (const char *name) const + Get first of preceding sibling nodes with the specified name.
+PUGIXML_DEPRECATED xml_node previous_sibling_w (const char_t *name) const - Get first of the preceding sibling nodes with the name that matches specified pattern.
+ Get first of the preceding sibling nodes with the name that matches specified pattern.
xml_node previous_sibling () const  Get preceding sibling.
@@ -127,30 +127,30 @@ bool operator! () cons xml_node root () const  Get root of DOM tree this node belongs to.
-const char * child_value () const +const char_t * child_value () const - Get child value of current node; that is, value of the first child node of type PCDATA/CDATA.
-const char * child_value (const char *name) const + Get child value of current node; that is, value of the first child node of type PCDATA/CDATA.
+const char_t * child_value (const char_t *name) const - Get child value of child with specified name.
-const char * child_value_w (const char *name) const + Get child value of child with specified name.
+PUGIXML_DEPRECATED const char_t * child_value_w (const char_t *name) const - Get child value of child with name that matches the specified pattern.
-bool set_name (const char *rhs) + Get child value of child with name that matches the specified pattern.
+bool set_name (const char_t *rhs) - Set node name to rhs (for PI/element nodes).
-bool set_value (const char *rhs) + Set node name to rhs (for PI/element nodes).
+bool set_value (const char_t *rhs) - Set node value to rhs (for PI/PCDATA/CDATA/comment nodes).
-xml_attribute append_attribute (const char *name) + Set node value to rhs (for PI/PCDATA/CDATA/comment nodes).
+xml_attribute append_attribute (const char_t *name) - Add attribute with specified name (for element nodes).
-xml_attribute insert_attribute_after (const char *name, const xml_attribute &attr) + Add attribute with specified name (for element nodes).
+xml_attribute insert_attribute_after (const char_t *name, const xml_attribute &attr) - Insert attribute with specified name after attr (for element nodes).
-xml_attribute insert_attribute_before (const char *name, const xml_attribute &attr) + Insert attribute with specified name after attr (for element nodes).
+xml_attribute insert_attribute_before (const char_t *name, const xml_attribute &attr) - Insert attribute with specified name before attr (for element nodes).
+ Insert attribute with specified name before attr (for element nodes).
xml_attribute append_copy (const xml_attribute &proto)  Add a copy of the specified attribute (for element nodes).
@@ -181,15 +181,15 @@ bool operator! () cons void remove_attribute (const xml_attribute &a)  Remove specified attribute.
-void remove_attribute (const char *name) +void remove_attribute (const char_t *name) - Remove attribute with the specified name, if any.
+ Remove attribute with the specified name, if any.
void remove_child (const xml_node &n)  Remove specified child.
-void remove_child (const char *name) +void remove_child (const char_t *name) - Remove child with the specified name, if any.
+ Remove child with the specified name, if any.
xml_attribute first_attribute () const  Get first attribute.
@@ -197,13 +197,13 @@ bool operator! () cons  Get last attribute.
template<typename OutputIterator> -void all_elements_by_name (const char *name, OutputIterator it) const +void all_elements_by_name (const char_t *name, OutputIterator it) const - Get all elements from subtree with given name.
+ Get all elements from subtree with given name.
template<typename OutputIterator> -void all_elements_by_name_w (const char *name, OutputIterator it) const +PUGIXML_DEPRECATED void all_elements_by_name_w (const char_t *name, OutputIterator it) const - Get all elements from subtree with name that matches given pattern.
+ Get all elements from subtree with name that matches given pattern.
xml_node first_child () const  Get first child.
@@ -222,51 +222,55 @@ bool operator! () cons xml_node find_node (Predicate pred) const  Find node from subtree using predicate.
-xml_node find_child_by_attribute (const char *name, const char *attr_name, const char *attr_value) const +xml_node find_child_by_attribute (const char_t *name, const char_t *attr_name, const char_t *attr_value) const - Find child node with the specified name that has specified attribute.
-xml_node find_child_by_attribute_w (const char *name, const char *attr_name, const char *attr_value) const + Find child node with the specified name that has specified attribute.
+PUGIXML_DEPRECATED xml_node find_child_by_attribute_w (const char_t *name, const char_t *attr_name, const char_t *attr_value) const - Find child node with the specified name that has specified attribute (use pattern matching for node name and attribute name/value).
-xml_node find_child_by_attribute (const char *attr_name, const char *attr_value) const + Find child node with the specified name that has specified attribute (use pattern matching for node name and attribute name/value).
+xml_node find_child_by_attribute (const char_t *attr_name, const char_t *attr_value) const - Find child node that has specified attribute.
-xml_node find_child_by_attribute_w (const char *attr_name, const char *attr_value) const + Find child node that has specified attribute.
+PUGIXML_DEPRECATED xml_node find_child_by_attribute_w (const char_t *attr_name, const char_t *attr_value) const - Find child node that has specified attribute (use pattern matching for attribute name/value).
-std::string path (char delimiter= '/') const + Find child node that has specified attribute (use pattern matching for attribute name/value).
+string_t path (char_t delimiter= '/') const - Get the absolute node path from root as a text string.
-xml_node first_element_by_path (const char *path, char delimiter= '/') const + Get the absolute node path from root as a text string.
+xml_node first_element_by_path (const char_t *path, char_t delimiter= '/') const - Search for a node by path.
+ Search for a node by path.
bool traverse (xml_tree_walker &walker)  Recursively traverse subtree with xml_tree_walker.
-xpath_node select_single_node (const char *query) const +xpath_node select_single_node (const char_t *query) const - Select single node by evaluating XPath query.
+ Select single node by evaluating XPath query.
xpath_node select_single_node (const xpath_query &query) const  Select single node by evaluating XPath query.
-xpath_node_set select_nodes (const char *query) const +xpath_node_set select_nodes (const char_t *query) const - Select node set by evaluating XPath query.
+ Select node set by evaluating XPath query.
xpath_node_set select_nodes (const xpath_query &query) const  Select node set by evaluating XPath query.
- -unsigned int document_order () const + +PUGIXML_DEPRECATED unsigned
+int document_order () const -void print (xml_writer &writer, const char *indent="\t", unsigned int flags=format_default, unsigned int depth=0) const +void print (xml_writer &writer, const char_t *indent=PUGIXML_TEXT("\t"), unsigned int flags=format_default, encoding_t encoding=encoding_auto, unsigned int depth=0) const - Print subtree to writer.
-void print (std::ostream &os, const char *indent="\t", unsigned int flags=format_default, unsigned int depth=0) const + Print subtree to writer.
+void print (std::basic_ostream< char, std::char_traits< char > > &os, const char_t *indent=PUGIXML_TEXT("\t"), unsigned int flags=format_default, encoding_t encoding=encoding_auto, unsigned int depth=0) const - Print subtree to stream.
-int offset_debug () const + Print subtree to stream.
+void print (std::basic_ostream< wchar_t, std::char_traits< wchar_t > > &os, const char_t *indent=PUGIXML_TEXT("\t"), unsigned int flags=format_default, unsigned int depth=0) const - Get node offset in parsed file/string (in bytes) for debugging purposes.
+ Print subtree to stream.
+ptrdiff_t offset_debug () const + + Get node offset in parsed file/string (in bytes) for debugging purposes.

Protected Types

typedef xml_node_struct *xml_node::* unspecified_bool_type @@ -275,12 +279,6 @@ typedef xml_node_struct *xml_node::*   xml_node (xml_node_struct *p) - -void precompute_document_order_impl () - - -xml_allocator & get_allocator () const -

Protected Attributes

xml_node_struct * _root @@ -799,13 +797,13 @@ Get node type. -

+

- + @@ -829,13 +827,13 @@ Get node name (element name for element nodes, PI target for PI).
const char* pugi::xml_node::name const char_t* pugi::xml_node::name (   ) 
-

+

- + @@ -859,7 +857,7 @@ Get node value (comment/PI/PCDATA/CDATA contents, depending on node type).
const char* pugi::xml_node::value const char_t* pugi::xml_node::value (   ) 
-

+

- + @@ -895,15 +893,15 @@ Get child with the specified name.
@@ -867,7 +865,7 @@ Get node value (comment/PI/PCDATA/CDATA contents, depending on node type).
xml_node pugi::xml_node::child ( const char * const char_t *  name  )  const
-

+

- + - + @@ -927,11 +925,12 @@ Get child with the name that matches specified pattern.
xml_node pugi::xml_node::child_w PUGIXML_DEPRECATED xml_node pugi::xml_node::child_w ( const char * const char_t *  name  )  const
name - child name pattern
-
Returns:
child with the name that matches pattern, if any; empty node otherwise
+
Returns:
child with the name that matches pattern, if any; empty node otherwise
+
Deprecated:
This function is deprecated
-

+

- + @@ -967,15 +966,15 @@ Get attribute with the specified name.
@@ -939,7 +938,7 @@ Get child with the name that matches specified pattern.
xml_attribute pugi::xml_node::attribute ( const char * const char_t *  name  )  const
-

+

- + - + @@ -999,11 +998,12 @@ Get attribute with the name that matches specified pattern.
xml_attribute pugi::xml_node::attribute_w PUGIXML_DEPRECATED xml_attribute pugi::xml_node::attribute_w ( const char * const char_t *  name  )  const
name - attribute name pattern
-
Returns:
attribute with the name that matches pattern, if any; empty attribute otherwise
+
Returns:
attribute with the name that matches pattern, if any; empty attribute otherwise
+
Deprecated:
This function is deprecated
-

+

- + @@ -1039,15 +1039,15 @@ Get first of following sibling nodes with the specified name.
@@ -1011,7 +1011,7 @@ Get attribute with the name that matches specified pattern.
xml_node pugi::xml_node::next_sibling ( const char * const char_t *  name  )  const
-

+

- + - + @@ -1071,7 +1071,8 @@ Get first of the following sibling nodes with the name that matches specified pa
xml_node pugi::xml_node::next_sibling_w PUGIXML_DEPRECATED xml_node pugi::xml_node::next_sibling_w ( const char * const char_t *  name  )  const
name - sibling name pattern
-
Returns:
node with the name that matches pattern, if any; empty node otherwise
+
Returns:
node with the name that matches pattern, if any; empty node otherwise
+
Deprecated:
This function is deprecated
@@ -1105,7 +1106,7 @@ Get following sibling.

-

+

- + @@ -1141,15 +1142,15 @@ Get first of preceding sibling nodes with the specified name.
@@ -1113,7 +1114,7 @@ Get following sibling.
xml_node pugi::xml_node::previous_sibling ( const char * const char_t *  name  )  const
-

+

- + - + @@ -1173,7 +1174,8 @@ Get first of the preceding sibling nodes with the name that matches specified pa
xml_node pugi::xml_node::previous_sibling_w PUGIXML_DEPRECATED xml_node pugi::xml_node::previous_sibling_w ( const char * const char_t *  name  )  const
name - sibling name pattern
-
Returns:
node with the name that matches pattern, if any; empty node otherwise
+
Returns:
node with the name that matches pattern, if any; empty node otherwise
+
Deprecated:
This function is deprecated
@@ -1267,13 +1269,13 @@ Get root of DOM tree this node belongs to.

-

+

- + @@ -1297,15 +1299,15 @@ Get child value of current node; that is, value of the first child node of type
const char* pugi::xml_node::child_value const char_t* pugi::xml_node::child_value (   ) 
-

+

- + - + @@ -1324,7 +1326,7 @@ Get child value of current node; that is, value of the first child node of type

Get child value of child with specified name.

-

See also:
child_value node.child_value(name) is equivalent to node.child(name).child_value()
+
See also:
child_value node.child_value(name) is equivalent to node.child(name).child_value()
Parameters:
const char* pugi::xml_node::child_value const char_t* pugi::xml_node::child_value ( const char * const char_t *  name  )  const
@@ -1334,15 +1336,15 @@ Get child value of child with specified name.
name - child name
-

+

- + - + @@ -1361,17 +1363,18 @@ Get child value of child with specified name.

Get child value of child with name that matches the specified pattern.

-

See also:
child_value node.child_value_w(name) is equivalent to node.child_w(name).child_value()
+
See also:
child_value node.child_value_w(name) is equivalent to node.child_w(name).child_value()
Parameters:
const char* pugi::xml_node::child_value_w PUGIXML_DEPRECATED const char_t* pugi::xml_node::child_value_w ( const char * const char_t *  name  )  const
name - child name pattern
-
Returns:
child value of specified child node, if any; "" otherwise
+
Returns:
child value of specified child node, if any; "" otherwise
+
Deprecated:
This function is deprecated
-

+

- + @@ -1398,7 +1401,7 @@ Get child value of child with name that matches the specified pattern.

Set node name to rhs (for PI/element nodes).

-

See also:
name
+
See also:
name
Parameters:
@@ -1379,7 +1382,7 @@ Get child value of child with name that matches the specified pattern.
bool pugi::xml_node::set_name ( const char * const char_t *  rhs  ) 
@@ -1408,7 +1411,7 @@ Set node name to rhs (for PI/element nodes).
rhs - new node name
-

+

- + @@ -1435,7 +1438,7 @@ Set node name to rhs (for PI/element nodes).

Set node value to rhs (for PI/PCDATA/CDATA/comment nodes).

-

See also:
value
+
See also:
value
Parameters:
@@ -1416,7 +1419,7 @@ Set node name to rhs (for PI/element nodes).
bool pugi::xml_node::set_value ( const char * const char_t *  rhs  ) 
@@ -1445,7 +1448,7 @@ Set node value to rhs (for PI/PCDATA/CDATA/comment nodes).
rhs - new node value
-

+

- + @@ -1481,7 +1484,7 @@ Add attribute with specified name (for element nodes).
@@ -1453,7 +1456,7 @@ Set node value to rhs (for PI/PCDATA/CDATA/comment nodes).
xml_attribute pugi::xml_node::append_attribute ( const char * const char_t *  name  ) 
-

+

- + @@ -1527,7 +1530,7 @@ Insert attribute with specified name after attr (for element nodes).
@@ -1489,7 +1492,7 @@ Add attribute with specified name (for element nodes).
xml_attribute pugi::xml_node::insert_attribute_after ( const char * const char_t *  name,
-

+

- + @@ -1992,7 +1995,7 @@ Remove specified attribute.
@@ -1535,7 +1538,7 @@ Insert attribute with specified name after attr (for element nodes).
xml_attribute pugi::xml_node::insert_attribute_before ( const char * const char_t *  name,
-

+

- + @@ -2062,7 +2065,7 @@ Remove specified child.
@@ -2000,7 +2003,7 @@ Remove specified attribute.
void pugi::xml_node::remove_attribute ( const char * const char_t *  name  ) 
-

+

- + @@ -2157,7 +2160,7 @@ Get last attribute.
@@ -2070,7 +2073,7 @@ Remove specified child.
void pugi::xml_node::remove_child ( const char * const char_t *  name  ) 
-

+

- + @@ -2206,7 +2209,7 @@ Get all elements from subtree with given name.
@@ -2169,7 +2172,7 @@ template<typename OutputIterator>
void pugi::xml_node::all_elements_by_name ( const char * const char_t *  name,
-

+

- + - + @@ -2249,9 +2252,10 @@ Get all elements from subtree with name that matches given pattern.
Parameters:
@@ -2216,9 +2219,9 @@ Get all elements from subtree with given name. template<typename OutputIterator>
void pugi::xml_node::all_elements_by_name_w PUGIXML_DEPRECATED void pugi::xml_node::all_elements_by_name_w ( const char * const char_t *  name,
- +
name - node name pattern
it - output iterator (for example, std::back_insert_iterator (result of std::back_inserter))
it - output iterator (for example, std::back_insert_iterator (result of std::back_inserter))
+

Deprecated:
This function is deprecated
@@ -2435,7 +2439,7 @@ Find node from subtree using predicate.

-

+

- + - + - + @@ -2488,27 +2492,27 @@ Find child node with the specified name that has specified attribute.
@@ -2443,19 +2447,19 @@ Find node from subtree using predicate.
xml_node pugi::xml_node::find_child_by_attribute ( const char * const char_t *  name,
const char * const char_t *  attr_name,
const char * const char_t *  attr_value
-

+

- + - + - + - + @@ -2537,11 +2541,12 @@ Find child node with the specified name that has specified attribute (use patter
xml_node pugi::xml_node::find_child_by_attribute_w PUGIXML_DEPRECATED xml_node pugi::xml_node::find_child_by_attribute_w ( const char * const char_t *  name,
const char * const char_t *  attr_name,
const char * const char_t *  attr_value
attr_value - pattern for attribute value of child node
-
Returns:
first matching child node, or empty node
+
Returns:
first matching child node, or empty node
+
Deprecated:
This function is deprecated
-

+

- + - + @@ -2587,21 +2592,21 @@ Find child node that has specified attribute.
@@ -2549,13 +2554,13 @@ Find child node with the specified name that has specified attribute (use patter
xml_node pugi::xml_node::find_child_by_attribute ( const char * const char_t *  attr_name,
const char * const char_t *  attr_value
-

+

- + - + - + @@ -2629,19 +2634,20 @@ Find child node that has specified attribute (use pattern matching for attribute
xml_node pugi::xml_node::find_child_by_attribute_w PUGIXML_DEPRECATED xml_node pugi::xml_node::find_child_by_attribute_w ( const char * const char_t *  attr_name,
const char * const char_t *  attr_value
attr_value - pattern for attribute value of child node
-
Returns:
first matching child node, or empty node
+
Returns:
first matching child node, or empty node
+
Deprecated:
This function is deprecated
-

+

+ +
- + - + @@ -2669,7 +2675,7 @@ Get the absolute node path from root as a text string.
std::string pugi::xml_node::path string_t pugi::xml_node::path ( char char_t  delimiter = '/'  )  const
-

+

- + - + @@ -2754,7 +2760,7 @@ Recursively traverse subtree with

+

@@ -2677,13 +2683,13 @@ Get the absolute node path from root as a text string.
xml_node pugi::xml_node::first_element_by_path ( const char * const char_t *  path,
char char_t  delimiter = '/'
- + @@ -2826,7 +2832,7 @@ Select single node by evaluating XPath query.
@@ -2762,7 +2768,7 @@ Recursively traverse subtree with xpath_node pugi::xml_node::select_single_node ( const char * const char_t *  query  )  const
-

+

- + @@ -2898,7 +2904,7 @@ Select node set by evaluating XPath query.
@@ -2834,7 +2840,7 @@ Select single node by evaluating XPath query.
xpath_node_set pugi::xml_node::select_nodes ( const char * const char_t *  query  )  const
-

+

- - + + @@ -2921,6 +2927,12 @@ Select node set by evaluating XPath query. + + + + + + @@ -2951,13 +2963,80 @@ Print subtree to writer. + + +
@@ -2912,8 +2918,8 @@ Select node set by evaluating XPath query.
const char *  indent = "\t", const char_t *  indent = PUGIXML_TEXT("\t"),
unsigned int  flags = format_default,
encoding_t  encoding = encoding_auto,
writer - writer object
indent - indentation string
flags - formatting flags
encoding - encoding used for writing
depth - starting depth (used for indentation)
+ +

+

+ + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
void pugi::xml_node::print ( std::basic_ostream< char, std::char_traits< char > > &  os,
const char_t *  indent = PUGIXML_TEXT("\t"),
unsigned int  flags = format_default,
encoding_t  encoding = encoding_auto,
unsigned int  depth = 0
)  const
+
+ + + +
+   + + +

+Print subtree to stream. +

+

Parameters:
+ + + + +
os - output stream
indent - indentation string
flags - formatting flags
encoding - encoding used for writing
depth - starting depth (used for indentation)
-

+

- + - - + + @@ -3010,20 +3089,20 @@ Print subtree to stream. +
@@ -2965,14 +3044,14 @@ Print subtree to writer.
void pugi::xml_node::print ( std::ostream & std::basic_ostream< wchar_t, std::char_traits< wchar_t > > &  os,
const char *  indent = "\t", const char_t *  indent = PUGIXML_TEXT("\t"),
os - output stream
indent - indentation string
flags - formatting flags
encoding - encoding used for writing
depth - starting depth (used for indentation)
-

Deprecated:
Use print() with xml_writer_stream instead
-

+

- + @@ -3048,7 +3127,7 @@ Get node offset in parsed file/string (in bytes) for debugging purposes.
int pugi::xml_node::offset_debug ptrdiff_t pugi::xml_node::offset_debug (   ) 
-
Generated on Tue Jan 5 20:02:12 2010 for pugixml by  +
Generated on Tue May 25 23:22:41 2010 for pugixml by  doxygen 1.4.6-NO
-- cgit v1.2.3