The XML Streams Package Character Encoding Requirements

SourcePro Core : XML Streams Module User’s Guide : International Features of the XML Streams Module : Determining your Character Encoding Needs : The XML Streams Package Character Encoding Requirements

The classes in the XML Streams package all read and write UTF-8 encoded documents. This means that the XML input streams take in UTF-8 only, and the XML output streams produce UTF-8 only.

You can, however, take advantage of various conversion utilities in SourcePro Core to convert your XML streams to and from any recognized character encoding. The Essential Tools Module and Internationalization Module contain classes that help you convert to and from UTF-8 prior to sending your data or character into the input stream, and after your data or character is returned by the output stream.

In addition, you may use a UTF-16 Unicode or wide character inserter or extractor interface to your XML streams, and the XML streams classes will internally convert between UTF-16 and UTF-8 as necessary. For a discussion on narrow character, wide, and Unicode interfaces, see Narrow Character Interfaces and Wide and Unicode Character Interfaces.

NOTE: If your strings are in a non-UTF-8 or UTF-16 encoding, you must first convert them before inserting them into an XML stream. For more information, see Using the XML Streams Package with the Internationalization Module.