[#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>`

Append to the buffer addressed by the specified `out` all pending output (if there is any) up to the optionally specified `maxNumOut` limit (default is negative, meaning no limit). When there is no pending output and the `maxNumOut` is still not reached, begin to consume and decode a sequence of input characters starting at the specified `begin` position, up to but not including the specified `end` position. Any resulting output is written to the `out` buffer up to the (cumulative) `maxNumOut` limit. If `maxNumOut` limit is reached, no further input will be consumed. Load into the (optionally) specified `numOut` and `numIn` the number of output bytes produced and input bytes consumed, respectively. Return 0 on success and a negative value otherwise. Note that calling this method after `endConvert` has been invoked without an intervening `reset` call will place this instance in an error state, and return an error status.


[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 characters in `[begin, end)]` writing output to `out`, with optional counts and an output limit. See the preceding overload for full contract details.


[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..._]#


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