[#BloombergLP-bdlde-QuotedPrintableDecoder-endConvert]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlde.adoc[bdlde]::xref:BloombergLP/bdlde/QuotedPrintableDecoder.adoc[QuotedPrintableDecoder]::endConvert
:relfileprefix: ../../../
:mrdocs:

Complete decoding and flush any retained output to `out`.

== Synopsis

Declared in `<bdlde_quotedprintabledecoder.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
int
endConvert(
    char* out,
    int* numOut,
    int maxNumOut = ‐1);
----

== Description

Terminate encoding for this decoder; write any retained output (e.g., from a previous call to `convert` with a non‐zero `maxNumOut` argument) to the specified `out` buffer. Optionally specify the `maxNumOut` limit on the number of bytes to output; if `maxNumOut` is negative, no limit is imposed. Load into the specified `numOut` the number of output bytes produced. Return 0 on success with no pending output, the positive number of bytes (if any) that would be output if `endConvert` were called with no output limit immediately upon exit from this method, and a negative value otherwise. Any retained bytes are available on a subsequent call to `endConvert`. Once this method is called, no additional input may be supplied without an intervening call to `reset`; once this method returns a zero status, a subsequent call will place this decoder in the error state, and return an error status.

== Return Value

0 on success with no pending output, a positive number of retained bytes if an output limit was reached, and a negative value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| destination for any retained decoded bytes
| *numOut*
| receives the number of bytes written
| *maxNumOut*
| maximum bytes to write; negative means no limit
|===


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