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 short`s, 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.