« XPCOM API Reference


The nsCStringEncoding enumeration describes the set of character encodings understood by the NS_CStringToUTF16 and NS_UTF16ToCString functions.

Conversion between ASCII and UTF-16 assumes that all bytes in the source string are 7-bit ASCII and can be inflated to UTF-16 by inserting null bytes. Reverse conversion is done by truncating every other byte. The conversion may result in loss and/or corruption of information if the strings do not strictly contain ASCII data.
Conversion between UTF-8 and UTF-16 is non-lossy.
Conversion from UTF-16 to the native filesystem charset may result in a loss of information. No attempt is made to protect against data loss in this case. The native filesystem charset applies to strings passed to the "Native" method variants on nsIFile and nsILocalFile.


This enumeration was frozen for Mozilla 1.7. See bug 239123 for details.

See Also

NS_CStringToUTF16, NS_UTF16ToCString

Document Tags and Contributors

 Contributors to this page: teoli, Biesi, Pmash
 Last updated by: Biesi,