API t_pblock *
LQT_GetpblockWhere
(db, WordInfo, AcceptFunc)
t_LQTEXT_Database *db;
t_WordInfo *WordInfo;
int (* AcceptFunc)(
#ifdef HAVE_PROTO
t_LQTEXT_Database *,
t_WID,
t_WordPlace *
#endif
);
Purpose
Look up a word in the database... and return a list of all the WordPlaces where it's found. The AcceptFunc is called for each place as it is read off the disk, with the given db, the WID and the new WordPlace as arguments. If the AcceptFunc returns a positive value, the WordPlace is accepted; otherwise, it is not included in the returned t_pblock. Note that it is possible to end up with a pblock with no WordPlaces at all if the AcceptFunc never returns a positive value. An AcceptFunc of NULL is considered to return 1 in every case.Returns
a freshly malloc'd t_pblock containing all of the WordPlaces from the disk that the AcceptFunc accepted, and with NumberOfWordPlaces set to the number of such places.
Errors
Database format errors are nearly always fatal.See Also: