1 files changed, 68 insertions, 0 deletions
diff --git a/docs/samples/load_stream.cpp b/docs/samples/load_stream.cpp
new file mode 100644
index 0000000..4aba8bd
--- /dev/null
+++ b/docs/samples/load_stream.cpp
@@ -0,0 +1,68 @@
+#include "pugixml.hpp"
+
+#include <fstream>
+#include <iomanip>
+#include <iostream>
+
+void print_doc(const char* message, const pugi::xml_document& doc, const pugi::xml_parse_result& result)
+{
+	std::cout
+		<< message
+		<< "\t: load result '" << result.description() << "'"
+		<< ", first character of root name: U+" << std::hex << std::uppercase << std::setw(4) << std::setfill('0') << pugi::as_wide(doc.first_child().name())[0]
+		<< ", year: " << doc.first_child().first_child().first_child().child_value()
+		<< std::endl;
+}
+
+int main()
+{
+	pugi::xml_document doc;
+
+	{
+		std::ifstream stream("weekly-utf-8.xml");
+		pugi::xml_parse_result result = doc.load(stream);
+
+		// first character of root name: U+9031, year: 1997
+		print_doc("UTF8 file from narrow stream", doc, result);
+	}
+
+	{
+		std::ifstream stream("weekly-utf-16.xml");
+		pugi::xml_parse_result result = doc.load(stream);
+
+		// first character of root name: U+9031, year: 1997
+		print_doc("UTF16 file from narrow stream", doc, result);
+	}
+
+	{
+		// Since wide streams are treated as UTF-16/32 ones, you can't load the UTF-8 file from a wide stream
+		// directly if you have localized characters; you'll have to provide a UTF8 locale (there is no
+		// standard one; you can use utf8_codecvt_facet from Boost (WHAT?))
+		std::wifstream stream("weekly-utf-8.xml");
+		pugi::xml_parse_result result = doc.load(stream);
+
+		// first character of root name: U+00E9, year: 1997
+		print_doc("UTF8 file from wide stream", doc, result);
+	}
+
+	{
+		// Since wide streams are treated as UTF-16/32 ones, you can't load the UTF-16 file from a wide stream
+		// at all; you'll have to provide a UTF16 locale (WHAT??)
+		std::wifstream stream("weekly-utf-16.xml");
+		pugi::xml_parse_result result = doc.load(stream);
+
+		// first character of root name: U+0000, year:
+		print_doc("UTF16 file from wide stream", doc, result);
+	}
+
+	{
+		// Since encoding names are non-standard, you can't load the Shift-JIS (or any other non-ASCII) file
+		// from a wide stream portably; this code assumes Microsoft C Runtime Libraries (WHAT???)
+		std::wifstream stream("weekly-shift_jis.xml");
+		stream.imbue(std::locale(".932"));
+		pugi::xml_parse_result result = doc.load(stream);
+
+		// first character of root name: U+9031, year: 1997
+		print_doc("Shift-JIS file from wide stream", doc, result);
+	}
+}