ImageGear for C and C++ on Windows v19.10 - Updated
IG_REC_approx_regex_match_cb_get
API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Approx Regex Functions > IG_REC_approx_regex_match_cb_get

Identifies the current approximate regex match callback.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_approx_regex_match_cb_get(
   const HIG_REC_APPROX_REGEX higRecApproxRegex,
   LPPFNIG_REC_APPROX_REGEX_MATCH_CB const  lppfnCallback,
   LPVOID* const  lppUserData
);

Arguments:

Name Type Description
higRecApproxRegex const HIG_REC_APPROX_REGEX The handle to an approximate regex instance.
lppfnCallback LPPFNIG_REC_APPROX_REGEX_MATCH_CB const The far pointer indicating where to return the callback invoked after a qualified match is made.
lppUserData LPVOID* const The far pointer indicating where to return the anonymous data passed to the callback function.

Return Value:

The number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Example:

 
Copy Code
AT_ERRCOUNT errCount = 0 ;
HIG_REC_APPROX_REGEX higRecApproxRegex = 0 ;
LPFNIG_REC_APPROX_REGEX_MATCH_CB user_callback = 0;
LPVOID user_data = 0 ;

IG_REC_approx_regex_create( &higRecApproxRegex ) ;
errCount = IG_REC_approx_regex_match_cb_get 
                          ( higRecApproxRegex, 
                            &user_callback,
                            &user_data
                          ) ;
IG_REC_approx_regex_delete( higRecApproxRegex ) ; 

Remarks:

The callback presents an opportunity for the caller to evaluate the match. Rejected matches shall not be included in the match result array.

See Also

HIG_REC_APPROX_REGEX