ImageGear for C and C++ on Windows v19.4 - Updated
IG_REC_output_format_next_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Output Functions > IG_REC_output_format_next_get

Continues the enumeration of the document output formats and returns the name of the next one.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_output_format_next_get(
   LPSTR lpszFormatName,
   AT_INT nBufferLength
);

Arguments:

Name Type Description
lpszFormatName LPSTR Buffer to receive the output format name.
nBufferLength AT_INT Length of the buffer.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT ErrCount = 0;
AT_ERRCODE ErrCode = IGE_SUCCESS;
char *lpszFormatName = malloc(AM_MAX_OUTPUT_FORMAT_NAME_LEN);

ErrCount += IG_REC_output_format_first_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN);
if(ErrCount == 0)
{
    while(ErrCode == IGE_SUCCESS)
    {
        ErrCount += IG_REC_output_format_next_get(lpszFormatName, AM_MAX_OUTPUT_FORMAT_NAME_LEN);
        IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0);
    }
}

//...

free(lpszFormatName);

Remarks:

As soon as the function finds no further formats to get, the warning IGW_LAST_ITEM_REACHED is added to the warning stack. Function IG_warning_check() returns non-zero value in this case, signaling that the list is complete. Maximal length of the format name is AM_MAX_OUTPUT_FORMAT_NAME_LEN.