[#BloombergLP-bdlde-Base64Encoder-convert-06]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/Base64Encoder.adoc[Base64Encoder]::convert
:relfileprefix: ../../../
:mrdocs:

`convert` overloads

== Synopses

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

Encode input bytes from `&lsqb;begin, end)&rsqb;` into Base64 at `out`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class OUTPUT&lowbar;ITERATOR,
    class INPUT&lowbar;ITERATOR&gt;
int
xref:BloombergLP/bdlde/Base64Encoder/convert-04.adoc[convert](
    OUTPUT&lowbar;ITERATOR out,
    INPUT&lowbar;ITERATOR begin,
    INPUT&lowbar;ITERATOR end);
----

[.small]#xref:BloombergLP/bdlde/Base64Encoder/convert-04.adoc[_» more&period;&period;&period;_]#

Encode input bytes from `&lsqb;begin, end)&rsqb;` into Base64 with limits&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class OUTPUT&lowbar;ITERATOR,
    class INPUT&lowbar;ITERATOR&gt;
int
xref:BloombergLP/bdlde/Base64Encoder/convert-05.adoc[convert](
    OUTPUT&lowbar;ITERATOR out,
    int* numOut,
    int* numIn,
    INPUT&lowbar;ITERATOR begin,
    INPUT&lowbar;ITERATOR end,
    int maxNumOut = &hyphen;1);
----

[.small]#xref:BloombergLP/bdlde/Base64Encoder/convert-05.adoc[_» more&period;&period;&period;_]#

== Return Value

* a non&hyphen;negative value on success, and a negative value otherwise
* a non&hyphen;negative value on success (positive means retained output bytes not yet written), and a negative value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| output iterator for encoded characters
| *begin*
| beginning of the input byte range
| *end*
| end of the input byte range (one past the last byte)
| *numOut*
| optionally receives the number of output bytes produced
| *numIn*
| optionally receives the number of input bytes consumed
| *maxNumOut*
| maximum output bytes to emit&semi; negative means no limit
|===


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