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

Finish encoding and write any retained output to `out`&period;

== Synopsis

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

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

== Description

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

== Return Value

a non&hyphen;negative value on success (the number of characters that would be output if `endConvert` were called with no limit), and a negative value otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *out*
| buffer to receive any retained encoded characters
| *numOut*
| receives the number of output bytes produced
| *maxNumOut*
| maximum output bytes to emit&semi; negative means no limit
|===


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