ImageGear for C and C++ on Windows v19.9 - Updated
IG_REC_converter_endparagraph_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Converter Settings Functions > IG_REC_converter_endparagraph_get

Returns the string to be inserted into the output text signifying the end of a paragraph.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_converter_endparagraph_get(
   LPCSTR lpszFormatName,
   LPAT_WCHAR lpwszEndParagraph,
   AT_INT nBufferLength
);

Arguments:

Name Type Description
lpszFormatName LPCSTR Symbolic name of the output format like Converters.Text.Cvs. See IG_REC_output_format_set for more info about format names.
lpwszEndParagraph LPAT_WCHAR Buffer to retrieve the end of a paragraph string.
nBufferLength AT_INT Length of lpwszEndParagraph buffer.

Return Value:

The number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
AT_INT iLength = 0;
AT_BOOL bCEPIsApplicable = FALSE;
LPCSTR lpszFormatName = "Converters.Text.Csv";
LPAT_WCHAR lpwszEndParagraph = 0;

ErrCount += IG_REC_output_format_set(lpszFormatName);
ErrCount += IG_REC_converter_endparagraph_is_applicable(lpszFormatName,
    &bCEPIsApplicable);
if(bCEPIsApplicable)
{
    ErrCount += IG_REC_converter_endparagraph_length_get(lpszFormatName, &iLength);
    lpwszEndParagraph = (LPAT_WCHAR) malloc((iLength + 1) * sizeof(AT_WCHAR));
    if(lpwszEndParagraph != NULL)
    {
        ErrCount += IG_REC_converter_endparagraph_get(lpszFormatName,
            lpwszEndParagraph, iLength);
        free(lpwszEndParagraph);
    }
}

Remarks:

The end paragraph string can't be retrieved if the corresponding output format has not been selected with IG_REC_output_format_set at least once. In this case the function returns a non-zero value and appends IGE_REC_CONVERTER_NOT_INITIALIZED error code to the error stack.