[#BloombergLP-bdlde-HexDecoder-convert-0e]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/HexDecoder.adoc[HexDecoder]::convert
:relfileprefix: ../../../
:mrdocs:

`convert` overloads

== Synopses

Declared in `<bdlde_hexdecoder.h>`

Decode hexadecimal input characters into binary output.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class OUTPUT_ITERATOR,
    class INPUT_ITERATOR>
int
xref:BloombergLP/bdlde/HexDecoder/convert-09.adoc[convert](
    OUTPUT_ITERATOR out,
    INPUT_ITERATOR begin,
    INPUT_ITERATOR end);
----

[.small]#xref:BloombergLP/bdlde/HexDecoder/convert-09.adoc[_» more..._]#

Decode hexadecimal input characters into binary output with limits.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class OUTPUT_ITERATOR,
    class INPUT_ITERATOR>
int
xref:BloombergLP/bdlde/HexDecoder/convert-05.adoc[convert](
    OUTPUT_ITERATOR out,
    int* numOut,
    int* numIn,
    INPUT_ITERATOR begin,
    INPUT_ITERATOR end,
    int maxNumOut = ‐1);
----

[.small]#xref:BloombergLP/bdlde/HexDecoder/convert-05.adoc[_» more..._]#

== Return Value

0 on success, and a negative value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| output iterator for decoded bytes
| *begin*
| beginning of the input range
| *end*
| end of the input range (exclusive)
| *numOut*
| receives the number of output bytes produced
| *numIn*
| receives the number of input bytes consumed
| *maxNumOut*
| maximum output bytes to emit; negative means no limit
|===


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