lq-text: LQT_MakeMatchesWhere

Purpose

Matches the given phrase, and returns the number of successful matches. The given AcceptFunction is called for each match; it must return one of the following flags as defined in <phrase.h>: either LQMATCH_ACCEPT, which adds the match to the result, or LQMATCH_REJECT, which does not add the match to the result. In addition, either of these flags may be combined (using bitwise or) with LQMATCH_QUIT, in which case LQT_Make­Matches­Where will return the result collected so far and abandon further processing, or LQMATCH_NEXT_FILE, in which case LQT_Make­Matches­Where will not call the AcceptFunction again until a match is found in a document with a different File Identifier (FID).

A NULL AcceptFunction pointer is equivalent to one that always returns LQMATCH_ACCEPT, except much more efficient.