BloombergLP::bdlde::CharConvertUtf32::utf8ToUtf32

Synopses

Declared in <bdlde_charconvertutf32.h>

Convert the UTF-8 source into UTF-32 in the destination vector.

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

» more...

Convert the UTF-8 srcString into UTF-32 in dstVector.

static
int
utf8ToUtf32(
    bsl::vector<unsigned int>* dstVector,
    char const* srcString,
    unsigned int errorWord = '?',
    ByteOrder::Enum byteOrder = ByteOrder::e_HOST);

» more...

Convert the UTF-8 source into UTF-32 in the destination vector.

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

» more...

Convert the UTF-8 source into UTF-32 in the destination vector.

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

» more...

Convert the UTF-8 source into UTF-32 in the destination vector.

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

» more...

Convert the UTF-8 source into UTF-32 in the destination vector.

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

» more...

Convert the UTF-8 source into UTF-32 in the destination buffer.

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

» more...

Convert the UTF-8 srcString into UTF-32 in dstBuffer.

static
int
utf8ToUtf32(
    unsigned int* dstBuffer,
    std::size_t dstCapacity,
    char const* srcString,
    std::size_t* numCodePointsWritten = 0,
    unsigned int 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 bit-wise OR of CharConvertStatus::Enum masks otherwise

Parameters

Name	Description
dstVector	destination for the UTF-32 conversion result
srcString	UTF-8 source string view to convert
errorWord	optional substitute for invalid encodings; 0 ignores them
byteOrder	byte order of the UTF-32 output (host by default)
dstBuffer	buffer for the UTF-32 conversion result
dstCapacity	capacity of `dstBuffer` in words
numCodePointsWritten	if non-null, receives the number of code points written (including the terminator)