<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/open.c">
<Name>LQT_OpenDatabase</Name>
<Class>Database/Database
<Purpose>
<P>Opens the lq-text database referred to in the given Options object;
flags and modes are as for open(2), although in all cases the
lq-text directory must already exist.</P>
<P>The only valid Options object at the moment is the
value returned by LQT_InitFromArgv, which can only be called once
during the lifetime of a process.</P>
<Notes>
Since you can currently only have a single database open in any
given program, there is not yet a need for a way to open a
specific database; this will change in the next release.
<Returns>
A pointer to an opaque object describing the database.
The pointer is suitable for use with LQT_CloseDatabase.
<SeeAlso>
LQT_InitFromArgv
LQT_CloseDatabase
</Function>
<Decl>
API t_LQTEXT_Database *
LQT_OpenDatabase(Options, flags, modes)
    t_lqdbOptions *Options;
    int flags;
    int modes;
</Decl>
</Entry>
