BloombergLP::bdlde::CharConvertUtf16::utf8ToUtf16

Synopses

Declared in <bdlde_charconvertutf16.h>

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

static
int
utf8ToUtf16(
    bsl::u16string* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    bsl::u16string* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::u16string* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::u16string* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::u16string* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::u16string* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Convert the UTF-8 source to UTF-16 in the destination.

static
int
utf8ToUtf16(
    bsl::wstring* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    bsl::wstring* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::wstring* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::wstring* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::wstring* dstString,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::wstring* dstString,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Convert the UTF-8 source to UTF-16 in the destination.

static
int
utf8ToUtf16(
    bsl::vector<unsigned short>* dstVector,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    bsl::vector<unsigned short>* dstVector,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::vector<unsigned short>* dstVector,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::pmr::vector<unsigned short>* dstVector,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::vector<unsigned short>* dstVector,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    std::vector<unsigned short>* dstVector,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Convert the UTF-8 source to UTF-16 in the destination.

static
int
utf8ToUtf16(
    char16_t* dstBuffer,
    std::size_t dstCapacity,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    char16_t* dstBuffer,
    std::size_t dstCapacity,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    char16_t errorChar = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Convert the UTF-8 source to UTF-16 in the destination.

static
int
utf8ToUtf16(
    unsigned short* dstBuffer,
    std::size_t dstCapacity,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    unsigned short* dstBuffer,
    std::size_t dstCapacity,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    unsigned short errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    wchar_t* dstBuffer,
    std::size_t dstCapacity,
    std::string_view const& srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

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

static
int
utf8ToUtf16(
    wchar_t* dstBuffer,
    std::size_t dstCapacity,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    std::size_t* numWordsWritten = 0,
    wchar_t errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Return Value

0 on success and a non-zero status otherwise
0 on success and CharConvertStatus::k_INVALID_INPUT_BIT otherwise
0 on success and a bitwise-or of the bits specified by CharConvertStatus::Enum 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
errorChar	replacement for invalid input, or 0 to skip
byteOrder	UTF-16 byte order; host order if unspecified
errorWord	replacement for invalid input, or 0 to skip
dstVector	destination for the converted output
dstBuffer	destination buffer for the converted output
dstCapacity	capacity of `dstBuffer` in elements
numWordsWritten	if non-null, set to the word count written