<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/wordinfo.c">
<Name>LQT_FindNextWIDMatchingPattern</Name>
<Class>Database/Retrieval, Database/Words
<Purpose>
<P>Returns the lowest WID whose word matches the given pattern,
and that is greater than the given WID argument.
The pattern is a string, which must be an all-lower-case prefix.
The given wildcard character must be either * or ?, to indicate
zero or more following characters or exactly one following character,
respectively.</P>
<P>The Prefix need not be nul-terminated; the given PrefixLength
argument is used to find the end of the prefix.</P>
<Returns>
The WID on success, and zero on failure.
<Errors>
Warns if a database format error is detected.
<SeeAlso>
LQT_FindFirstWIDMatchingPattern
</Function>
<Decl>
API t_WID
LQT_FindNextWIDMatchingPattern(
    db,
    WID,
    Pattern,
    PatternLength,
    PrefixLength,
    Matcher,
    Argument
)
    t_LQTEXT_Database *db;
    t_WID WID;
    unsigned char *Pattern;
    int PatternLength;
    int PrefixLength;
    int (* Matcher)(
# ifdef HAVE_PROTO
	t_LQTEXT_Database *thedb,
	unsigned char *theString,
	int theStringLength,
	unsigned char *thePattern,
	int thePatternLength,
	int thePrefixLength,
	unsigned char *theArgument
# endif
    );
    unsigned char *Argument;
</Decl>
</Entry>
