<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqtext">
<Function File="../../src/liblqtext/trace.c">
<Name>LQT_SetTraceFile</Name>
<Class>Tracing
<Purpose>
<P>After this call, all lq-text tracing output produced with LQT_Trace
will be sent to the given file.
It is the caller's responsibility to ensure that the given FILE * is
valid and points to a file that is open for writing.</P>
<P>The default file used before LQT_SetTraceFile has been called is
stderr.
An argument of (FILE *) NULL will reset the file to the default value,
but will not close the given stream.
The file is also not when a database is closed;
see LQT_AddActionOnClose for a way of changing this behaviour.</P>
<Returns>
the previous file pointer
<SeeAlso>
LQT_Trace
LQT_SetTraceFlag
LQT_AddActionOnClose
</Function>
<Decl>
API FILE *
LQT_SetTraceFile(newFile)
    FILE *newFile;
</Decl>
</Entry>
