[#BloombergLP-bdlde-Base64Decoder-convert-08]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/Base64Decoder.adoc[Base64Decoder]::convert
:relfileprefix: ../../../
:mrdocs:

Decode Base64 characters from `&lsqb;begin, end)&rsqb;` into `out`&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class OUTPUT&lowbar;ITERATOR,
    class INPUT&lowbar;ITERATOR&gt;
int
convert(
    OUTPUT&lowbar;ITERATOR out,
    INPUT&lowbar;ITERATOR begin,
    INPUT&lowbar;ITERATOR end);
----

== Description

Decode the sequence of input characters starting at the specified `begin` position up to, but not including, the specified `end` position, writing any resulting output characters to the specified `out` buffer&period; Return a non&hyphen;negative value on success, &hyphen;1 on an input error, and &hyphen;2 if the `endConvert` method has already been called without an intervening `resetState` call&period; Note that it is recommended that after all calls to `convert` are finished, the `endConvert` method be called to complete the decoding of any unprocessed input characters that do not complete a 3&hyphen;byte sequence&period;

== Return Value

non&hyphen;negative value on success, &hyphen;1 on input error, and &hyphen;2 if `endConvert` has already been called without an intervening `resetState`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| destination for decoded output bytes
| *begin*
| beginning of the Base64 input range
| *end*
| end of the Base64 input range (exclusive)
|===


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