<!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_Trace</Name>
<Class>Tracing
<Purpose>
<P>Prints diagnostic messages.
The Flags argument must be one or more flags
taken from <h>lqtrace.h</h> and combined with bitwise or.
If one of more of the given Flags is set in the current lq-text
trace flags, the remainder of the arguments are passed to fprintf</P>
<P>For efficiency, it may be best to use LQT_TraceFlagsSet first
to determine whether to call LQT_Trace, as the former is likely
to be implemented as a short macro in <h>lqtrace.h</h>, but
currently LQT_Trace cannot be so implemented.</P>
<P>Each line of trace output is preceded by the current program name,
the word `trace', and a string representation of 
one or more of those flags in the Flags argument to LQT_Trace which
are set in the current lqtext trace flags.</P>
<SeeAlso>
LQT_SetTraceFlag
LQT_UnSetTraceFlag
LQT_SetTraceFlagsFromString
</Function>
<Decl>
API void
LQT_Trace(Flags, Format, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o)
    t_TraceFlag Flags;
    char *Format;
</Decl>
</Entry>
