<!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_SetTraceFlagsFromString</Name>
<Class>Tracing
<Purpose>
<P>Attempts to set the lq-text trace flags by reading a string
representation of them.
The string must be in the format produced by LQT_GetTraceFlagsAsString;
in other words, a sequence of words separated by the vertical bar.
The various flag values are defined in the <h>lqtrace.h</h> header
file, and may be combined (using bitwise or) in any combination</P>
<P>If the return value points to a NUL byte, the end of the string
was reached without error; otherwise, it is up to the caller to
determine whether the extra unconverted text was expected.
<Returns>
a pointer to the first unconverted character in the given string
<SeeAlso>
LQT_Trace
LQT_SetTraceFlag
LQT_GetTraceFlagsAsString
LQT_StringToFlags
</Function>
<Decl>
API char *
LQT_SetTraceFlagsFromString(theString)
    char *theString;
</Decl>
</Entry>
