From 234d4c030f0779bde628888f91447f172248f0e4 Mon Sep 17 00:00:00 2001 From: "arseny.kapoulkine@gmail.com" Date: Thu, 8 Mar 2012 04:06:34 +0000 Subject: docs: Documented the fact that error descriptions are always const char* regardless of char/wchar_t mode git-svn-id: http://pugixml.googlecode.com/svn/trunk@853 99668b35-9821-0410-8761-19e4c4f06640 --- docs/manual.qbk | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/manual.qbk') diff --git a/docs/manual.qbk b/docs/manual.qbk index 1c78b1a..233fd2f 100644 --- a/docs/manual.qbk +++ b/docs/manual.qbk @@ -616,7 +616,7 @@ Parsing status is represented as the `xml_parse_status` enumeration and can be o * [anchor status_end_element_mismatch] means that parsing stopped because the closing tag did not match the opening one (i.e. ``) or because some tag was not closed at all [#xml_parse_result::description] -`description()` member function can be used to convert parsing status to a string; the returned message is always in English, so you'll have to write your own function if you need a localized string. However please note that the exact messages returned by `description()` function may change from version to version, so any complex status handling should be based on `status` value. +`description()` member function can be used to convert parsing status to a string; the returned message is always in English, so you'll have to write your own function if you need a localized string. However please note that the exact messages returned by `description()` function may change from version to version, so any complex status handling should be based on `status` value. Note that `description()` returns a `char` string even in `PUGIXML_WCHAR_MODE`; you'll have to call [link as_wide] to get the `wchar_t` string. If parsing failed because the source data was not a valid XML, the resulting tree is not destroyed - despite the fact that load function returns error, you can use the part of the tree that was successfully parsed. Obviously, the last element may have an unexpected name/value; for example, if the attribute value does not end with the necessary quotation mark, like in [^