ImageGear Professional DLL v17.1 for Windows Accusoft
IG_REC_approx_regex_search_text
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_search_text

Glossary Item Box

Matches text from a Unicode string.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_approx_regex_search_text(
   const HIG_REC_APPROX_REGEX higRecApproxRegex,
   const LPAT_WCHAR text,
   const AT_REC_MATCH_RESULT **const  match_result_array,
   AT_INT *const  match_result_size
);

Arguments:

higRecApproxRegex The handle to an approximate regex instance.
text The Unicode string to search.
match_result_array A pointer to a vector of match result instances. The approximate regex owns this data. Callers that require access to this data after the approximate regex is deleted must duplicate this data and assume ownership of the copy.
match_result_size The number of match results in match_result_array.

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:

Text is scanned for pattern matches.

The following installed callbacks are invoked during execution of this function:

No recognition information will be reported in match_result_array.

Example:

  Copy Code
AT_ERRCOUNT errCount = 0 ;
HIG_REC_APPROX_REGEX higApproxRegex = 0 ;
LPAT_WCHAR patterns [] = { L".+" } ;
const AT_REC_MATCH_RESULT* match_result_array = 0 ;
AT_INT match_result_size = 0 ;

IG_REC_approx_regex_create( &higApproxRegex ) ;
IG_REC_approx_regex_pattern_set( higApproxRegex , patterns , 1 ) ;
errCount = IG_REC_approx_regex_search_text 
                          ( higApproxRegex, 
                            L"Who is your daddy and what does he do?",
                            &match_result_array,
                            &match_result_size
                          ) ;
IG_REC_approx_regex_delete( higApproxRegex ) ;

See Also

HIG_REC_APPROX_REGEX

©2012. Accusoft Corporation. All Rights Reserved.