Load into the destination the UTF‐8 conversion of the UTF‐16 source.

Synopsis

Declared in <bdlde_charconvertutf16.h>

static
int
utf16ToUtf8(
    std::pmr::string* dstString,
    std::wstring_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    char errorByte = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

Description

Return 0 on success and a non‐zero status otherwise. See the first utf16ToUtf8 overload in this group for full contract details.

Return Value

0 on success and a non‐zero status otherwise

Parameters

Name

Description

dstString

destination for the converted output

srcString

source string to convert

numCodePointsWritten

if non‐null, set to the code‐point count written

errorByte

replacement for invalid input, or 0 to skip

byteOrder

UTF‐16 byte order; host order if unspecified

Created with MrDocs