Convert the UTF-32 source of given length into UTF-8 in dstVector.
Declared in <bdlde_charconvertutf32.h>
static
int
utf32ToUtf8(
bsl::vector<char>* dstVector,
unsigned int const* srcString,
std::size_t srcStringLength,
std::size_t* numCodePointsWritten = 0,
unsigned char errorByte = '?',
ByteOrder::Enum byteOrder = ByteOrder::e_HOST);Load into the destination the UTF-8 conversion of the UTF-32 source. Return 0 on success and a non-zero status otherwise. See the first utf32ToUtf8 overload in this group for full contract details.
0 on success and a non-zero status otherwise
| Name | Description |
|---|---|
| dstVector | destination for the null-terminated UTF-8 result |
| srcString | UTF-32 source buffer to convert |
| srcStringLength | number of UTF-32 values to convert |
| numCodePointsWritten | if non-null, receives the number of UTF-8 code points written |
| errorByte | optional substitute for invalid UTF-32 values; 0 writes nothing |
| byteOrder | byte order of the UTF-32 input (host by default) |