<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/freephr.c">
<Name>LQT_DestroyPhrase</Name>
<Class>Retrieval/Phrases, Memory
<Purpose>
<P>Frees any memory associated with the given phrase,
and then frees the Phrase itself.
After calling LQT_DestroyPhrase, it is an error to attempt to
dereference the Phrase, and the operating system may detect this
and raise an exception or send a fatal signal.</P>
<Notes>
LQT_DestroyPhrase does not follow the Next element of the given Phrase.
A caller doing this should take a copy of Phrase->Next before calling
LQT_DestroyPhrase, as after the call the pointer itself will be
inaccessible.
<SeeAlso>
LQT_StringToPhrase
</Function>
<Decl>
API void
LQT_DestroyPhrase(db, Phrase)
    t_LQTEXT_Database *db;
    t_Phrase *Phrase;
</Decl>
</Entry>
