ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_wstring_array_free
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Utility Functions > IG_REC_wstring_array_free

Glossary Item Box

Deletes a string array previously allocated by the toolkit.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_wstring_array_free(
   AT_WCHAR ** lplpStringArray,
   AT_INT nArrayLength
);

Arguments:

lplpStringArray String array to be deleted.
nArrayLength Number of strings in the array.

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.

Remarks:

This functions deletes arrays being allocated by such functions as IG_REC_word_suggestions_get, IG_REC_alternative_letter_codes_get.

Example:

  Copy Code
AT_ERRCOUNT ErrCount = 0;
HIGEAR higImage = 0;
HIG_REC_IMAGE higRecImage = 0; 
AT_WCHAR** lplpAlternativeCodes = 0;
AT_INT nAlternativeCodesCount = 0;

ErrCount += IG_load_file("Image.tif", &higImage); 
ErrCount += IG_REC_image_import(higImage, &higRecImage);
ErrCount += IG_REC_image_recognize(higRecImage);
ErrCount += IG_REC_alternative_letter_codes_get(higRecImage,
    &lplpAlternativeCodes,  &nAlternativeCodesCount);

//...

ErrCount += IG_REC_wstring_array_free(lplpAlternativeCodes, nAlternativeCodesCount);
ErrCount += IG_REC_image_delete(higRecImage);
ErrCount += IG_image_delete(higImage);

©2012. Accusoft Corporation. All Rights Reserved.