LlDefineVariableStart

Syntax:

void LlDefineVariableStart (HLLJOB hJob);

Task:

Empties List & Label's internal variable buffer in order to delete old definitions.

Parameter:

hJob: List & Label job handle

Hints:

Does not necessarily have to be called. However, as with every LlDefineVariable...() the internal variable list is checked for a variable which is already available with the same name and type, this can be somewhat accelerated with this function. Otherwise you only need to redefine the variables whose contents change as the old contents of the variable are " over-written" ; the contents of the remaining variables remain the same.

If you use LlPrintIsVariableUsed(), LlDefineVariableStart() may not be called after the invocation of LlPrint[WithBox]Start(), otherwise LlPrintIsVariableUsed() will always return FALSE.

Important: This function must not be called within the print loop!

Example:

HLLJOB hJob;
hJob = LlJobOpen(0);
LlDefineVariableStart(hJob);
LlDefineVariable(hJob, "Name", "Smith");
LlDefineVariable(hJob, "Forename", "George");
<...etc ...>
LlDefineVariable(hJob, "Forename", "James");
<... etc ...>
LlJobClose(hJob);