Complete decoding and flush any retained output to out.

Synopsis

Declared in <bdlde_quotedprintabledecoder.h>

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

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

Created with MrDocs