Trace_Out

include debug.inc

Trace_Out String, nocrlf
Trace_Out String, level

Writes the specified string to the debugging device, but continues execution. Compare the Debug_Out macro, which stops execution if a debugger is attached.

• No return value.

String

String to display, enclosed in double quotation marks. The string can contain register placeholders in the same forms as described for the Out_Debug_String service.

level

Optional symbol indicating the debugging level for which code should be generated. If the value of the Deblevel symbol is greater than or equal to level, then code is generated. Otherwise, code is not generated. The symbol can be DeblevelNormal or DeblevelMax. The default is DeblevelNormal.

nocrlf

Optional parameter specifying that the macro should not append a carriage return and newline character combination to the string. If this parameter is not given, the macro appends the character combination by default.

The assembler generates code for the macro only if the DEBUG constant is defined before including the DEBUG.INC file.

There are additional macros Trace_OutX, where X is a conditional jump type, i.e., something that can follow the letter j to form a conditional jump instruction. In such case, the trace-out is performed only if the condition is satisfied.

The following example writes a string to the debugging device:

Trace_Out "Element not found"

The following example writes a string containing the value of the AX register to the debugging device if the zero flag is set:

Trace_OutZ "AX value is #AX"

See also Out_Debug_String