[#BloombergLP-bdlde-HexEncoder-convert-00]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/HexEncoder.adoc[HexEncoder]::convert
:relfileprefix: ../../../
:mrdocs:

Encode input characters to hexadecimal output&period;

== Synopsis

Declared in `&lt;bdlde&lowbar;hexencoder&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

Append pending output (if any) addressed by the specified `out`, then consume and encode input from the specified `begin` up to but not including the specified `end`&period; Return a non&hyphen;negative value on success and a negative value otherwise&period; Note that after all calls to `convert` are finished, `endConvert` should be called to complete encoding of any unprocessed input&period;

== Return Value

a non&hyphen;negative value on success, and a negative value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| destination iterator for encoded output
| *begin*
| beginning of the input range to encode
| *end*
| end of the input range (one past the last element)
|===


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