<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/pbcache.c">
<Name>LQT_DeleteWordPlaces</Name>
<Class>Database/Update, Database/Words
<Purpose>
<P>Deletes the word places from disk for a given WID, marking the
corresponding data blocks as unused.<P>
<P>The given FirstBlock argument is the first block in the chain of
the linked list of blocks for the given WID.  If the data is
contained entirely in the WID index block, LQT_DeleteWordPlaces
should not be called, and this is a fatal error.</P>
<P>LQT_DeleteWordPlaces does not remove the WID <--> Word mapping
from the wordlist Key Value Database, and does not zero out the
information in the widindex block.</P>
<Errors>
Fatal (E_BUG) error if FirstBlock or WID are zero.
<SeeAlso>
LQT_Deletepblock
</Function>
<Decl>
API void
LQT_DeleteWordPlaces(db, FirstBlock, WID)
    t_LQTEXT_Database *db;
    unsigned long FirstBlock;
    t_WID WID;
</Decl>
</Entry>
