ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_approx_regex_maximum_insert_count_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Recognition Component API Reference > Recognition Component Functions Reference > Approx Regex Functions > IG_REC_approx_regex_maximum_insert_count_get

Glossary Item Box

Identifies the maximum Insert count.

Declaration:

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

Arguments:

higRecApproxRegex The handle to an approximate regex instance.
lpCount The far pointer indicating where to return the maximum Insertions 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.

Remarks:

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

The default value is 1.

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

where 'a' could be replaced by any single character. The following examples would not match (though both would match if preceded by a 1): Note that for a12345 or 12345a, 'a' would not be returned in a match. Since 12345 matches the pattern exactly in both those sequences, only the exact match part of the sequence would be reported.

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_insert_count_get
                          ( higRecApproxRegex, 
                            &count 
                          ) ;
IG_REC_approx_regex_delete( higRecApproxRegex ) ;

See Also

HIG_REC_APPROX_REGEX

©2012. Accusoft Corporation. All Rights Reserved.