[#BloombergLP-bdlde-CharConvertUtf32-utf8ToUtf32-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/CharConvertUtf32.adoc[CharConvertUtf32]::utf8ToUtf32
:relfileprefix: ../../../
:mrdocs:

Convert the UTF&hyphen;8 source into UTF&hyphen;32 in the destination vector&period;

== Synopsis

Declared in `&lt;bdlde&lowbar;charconvertutf32&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
utf8ToUtf32(
    xref:bsl/vector-00d.adoc[bsl::vector&lt;unsigned int&gt;]* dstVector,
    std::string&lowbar;view const& srcString,
    unsigned int errorWord = &apos;?&apos;,
    xref:BloombergLP/bdlde/ByteOrder/Enum.adoc[ByteOrder::Enum] byteOrder = ByteOrder&colon;&colon;e&lowbar;HOST);
----

== Description

Load into the destination the UTF&hyphen;32 conversion of the UTF&hyphen;8 source&period; Return 0 on success and a non&hyphen;zero status otherwise&period; See the first `utf8ToUtf32` overload in this group for full contract details&period;

== Return Value

0 on success and a non&hyphen;zero status otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *dstVector*
| destination for the UTF&hyphen;32 conversion result
| *srcString*
| UTF&hyphen;8 source string view to convert
| *errorWord*
| optional substitute for invalid encodings&semi; 0 ignores them
| *byteOrder*
| byte order of the UTF&hyphen;32 output (host by default)
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
