lq-text: LQT_DestroyPhrase

API void LQT_DestroyPhrase (db, Phrase) t_LQTEXT_Database *db; t_Phrase *Phrase;

Purpose

Frees any memory associated with the given phrase, and then frees the Phrase itself. After calling LQT_Destroy­Phrase, 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.

See Also:

Notes

LQT_Destroy­Phrase does not follow the Next element of the given Phrase. A caller doing this should take a copy of Phrase->Next before calling LQT_Destroy­Phrase, as after the call the pointer itself will be inaccessible.