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

Identifies the maximum Substitute count.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_approx_regex_maximum_substitute_count_get(
   const HIG_REC_APPROX_REGEX higRecApproxRegex,
   const LPAT_INT lpCount
);

Arguments:

Name Type Description
higRecApproxRegex const HIG_REC_APPROX_REGEX The handle to an approximate regex instance.
lpCount const LPAT_INT The far pointer indicating where to return the maximum Substitutions allowed for a fuzzy search match.

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 ;
AT_INT count = 0 ;

IG_REC_approx_regex_create( &higRecApproxRegex ) ;
errCount = IG_REC_approx_regex_maximum_substitute_count_get 
                          ( higRecApproxRegex,
                            &count 
                          ) ;
IG_REC_approx_regex_delete( higRecApproxRegex ) ;

Remarks:

Establishes the maximum number of Substitutions allowed for a fuzzy search match. A match is only reported if the total count of Substitutions does not exceed this threshold.

The default value is 1.

With maximum error count and maximum substitute count set to 1, and maximum insert count and maximum delete count set to 0, the following strings match the pattern "12345":

where 'a' can be replaced by any single character. The following examples would not match:

See Also

HIG_REC_APPROX_REGEX