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

Continues the enumeration of the available Code Pages and returns the name of the next one. Maximum length of the code page name is AM_MAX_CP_NAME_LEN.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_output_codepage_next_get(
   LPSTR pCodePageName,
   AT_INT nBufferLength
);

Arguments:

Name Type Description
pCodePageName LPSTR Pointer of a buffer for the name of the next available Code Page.
nBufferLength AT_INT Length of pCodePageName 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;
LPSTR lpszCodepage = 0;
AT_INT iCodepageLen = AM_MAX_CP_NAME_LEN;

lpszCodepage = (LPSTR) malloc(iCodepageLen);
ErrCount += IG_REC_output_codepage_first_get(lpszCodepage, iCodepageLen);
while(ErrCode == IGE_SUCCESS)
{
    //...

    ErrCount += IG_REC_output_codepage_next_get(lpszCodepage, iCodepageLen);
    IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0);
}

free(lpszCodepage);

Remarks:

As soon as the function finds no further code pages to get, the warning IGW_LAST_ITEM_REACHED is added to the warning stack. Function IG_warning_check() returns a non-zero value in this case, signaling that the list is complete.