lq-text: LQT_SetTraceFile

API FILE * LQT_SetTraceFile (newFile) FILE *newFile;

Purpose

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.

The default file used before LQT_Set­Trace­File 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_Add­Action­On­Close for a way of changing this behaviour.

Returns

the previous file pointer

See Also: