From 7e7153457722ff2272bf094cca5387bd2e2ebd71 Mon Sep 17 00:00:00 2001 From: "arseny.kapoulkine@gmail.com" Date: Sun, 29 Apr 2012 22:51:21 +0000 Subject: docs: Regenerated HTML documentation git-svn-id: http://pugixml.googlecode.com/svn/trunk@908 99668b35-9821-0410-8761-19e4c4f06640 --- docs/manual/loading.html | 44 ++++++++++++++++++++++++++++++++------------ 1 file changed, 32 insertions(+), 12 deletions(-) (limited to 'docs/manual/loading.html') diff --git a/docs/manual/loading.html b/docs/manual/loading.html index 5b5576b..a26b62c 100644 --- a/docs/manual/loading.html +++ b/docs/manual/loading.html @@ -4,15 +4,15 @@ Loading document - - + +
-pugixml 1.0 manual | +pugixml 1.2 manual | Overview | Installation | Document: @@ -282,10 +282,6 @@

-

- Stream loading requires working seek/tell functions and therefore may fail - when used with some stream implementations like gzstream. -

@@ -384,7 +380,9 @@ returned by description() function may change from version to version, so any complex status handling should be based on status - value. + value. Note that description() returns a char + string even in PUGIXML_WCHAR_MODE; + you'll have to call as_wide to get the wchar_t string.

If parsing failed because the source data was not a valid XML, the resulting @@ -533,6 +531,25 @@ " "), and only one child when parse_ws_pcdata is not set. This flag is off by default. +

+ + +

  • + parse_ws_pcdata_single determines + if whitespace-only PCDATA nodes that have no sibling nodes are to be + put in DOM tree. In some cases application needs to parse the whitespace-only + contents of nodes, i.e. <node> + </node>, but is not interested in whitespace + markup elsewhere. It is possible to use parse_ws_pcdata + flag in this case, but it results in excessive allocations and complicates + document processing in some cases; this flag is intended to avoid that. + As an example, after parsing XML string <node> + <a> </a> </node> with parse_ws_pcdata_single + flag set, <node> element will have one child <a>, and <a> + element will have one child with type node_pcdata + and value " ". + This flag has no effect if parse_ws_pcdata + is enabled. This flag is off by default.

    • @@ -581,8 +598,7 @@ attributes. This means, that after attribute values are normalized as if parse_wconv_attribute was set, leading and trailing space characters are removed, and all sequences - of space characters are replaced by a single space character. The value - of parse_wconv_attribute + of space characters are replaced by a single space character. parse_wconv_attribute has no effect if this flag is on. This flag is off by default. @@ -755,6 +771,10 @@ or encoding_utf32, depending on wchar_t size. +

  • + encoding_latin1 corresponds to ISO-8859-1 + encoding (also known as Latin-1). +

    • The algorithm used for encoding_auto @@ -828,7 +848,7 @@

    - @@ -836,7 +856,7 @@
    Copyright © 2010 Arseny Kapoulkine

    +

    Copyright © 2012 Arseny Kapoulkine

    Distributed under the MIT License

    -pugixml 1.0 manual | +pugixml 1.2 manual | Overview | Installation | Document: -- cgit v1.2.3