<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/fileinfo.c">
<Name>LQT_FIDToFileInfo</Name>
<Class>Database/Retrieval, Database/Documents
<Purpose>
Returns the in-memory t_FileInfo struct associated with a given FID,
reading the information from the database as necessary.
The returned value, if non-zero, is created with malloc; it is
the caller's responsibility to free the storage.
<SeeAlso>
LQT_NameToFID, LQT_DestroyFileInfo
<Returns>
<LIST>
<LI>the t_FileInfo * on success;
<LI>NULL on error.
</LIST>
<Errors>
Warns if the database can't be opened.
<SeeAlso>
LQT_NameToFID
LQT_DestroyFileInfo
</Function>
<Decl>
API t_FileInfo *
LQT_FIDToFileInfo(db, FID)
    t_LQTEXT_Database *db;
    t_FID FID;
</Decl>
</Entry>
