ImageGear for C and C++ on Windows v19.4 - Updated
IG_REC_UD_section_next_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > User Dictionary Functions > IG_REC_UD_section_next_get

This function has been deprecated and will be removed from the public API in a future release.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_UD_section_next_get(
   LPSTR pSection,
   AT_INT buflen
);

Arguments:

Name Type Description
pSection LPSTR Pointer to a buffer for the name of the first section in the User dictionary.
buflen AT_INT Specifies the size of the buffer in bytes.

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;
AT_INT iSize =  1024;
LPSTR lpszFirst = (LPSTR) malloc(iSize);

ErrCount += IG_REC_UD_set("NEW_USER2.DICT", "Section_A");
ErrCount += IG_REC_UD_edit_open();

ErrCount += IG_REC_UD_section_first_get(lpszFirst, iSize);
while(ErrCode == IGE_SUCCESS)
{
    ErrCount += IG_REC_UD_section_next_get(lpszFirst, iSize);
    IG_warning_get(0, NULL, 0, NULL, &ErrCode, NULL, NULL, NULL, 0);
}

ErrCount += IG_REC_UD_edit_close();
free(lpszFirst);

Remarks:

Creates a listing of the sections in the User dictionary currently opened for editing by the IG_REC_UD_edit_open function.

This function should be used together with IG_REC_UD_section_first_get

  1. The lengths of each section name never exceeds AM_MAX_UD_SECTION_NAME_LEN characters (including the terminating zero).
  2. Repeated calls to this function get a sequence of the sections and generate a return 0 each time. As soon as the function finds no further section 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.