BloombergLP::bdlde::CharConvertUcs2

This struct provides a namespace for a suite of pure procedures to convert character buffers between UTF-8 and UCS-2. UCS-2 conversions are performed to/from the full 2 ^ 16 bit space (the "UTF-16" hole U+D800-U+DFFF is not treated as a special case). Note that all C-style routines in this component honor strlcpy semantics, meaning that all returned C-style strings will be null-terminated as long as the return buffer size is positive (i.e., dstCapacity > 0). Note that since all UCS-2 operations take place as unsigned shorts, byte order is not taken into consideration, and Byte Order Mark (BOM) characters are not generated. If a BOM is present in the input, it will be translated into the output.