DEBUGOUT

Purpose

Write a debugout logging text message

Syntax

DEBUGOUT <expC>

See Also

CLOSE ALTERNATE, SET ALTERNATE, SET DEBUGOUT, SET ERRORLOGGING

Description

With SET DEBUGOUT ON, the DEBUGOUT command can be used to log text messages to the debug.txt file in the Lianja debug sub-directory. The DEBUGOUT command is ignored if SET DEBUGOUT is OFF.

By default, SET DEBUGOUT is OFF.

Example

// debugdoc.prg
set debugout on
debugout "about to open database"
open database southwind
debugout "about to open table"
use example
replace all available with limit - balance
debugout "after replace"
close databases
debugout "after close data"
set debugout off
// Following line will not be logged:
debugout "no need to log this"
// end

debug.txt contents:

*
* Lianja embedded database engine
* Version 10.0.4
* Compiled on Dec  6 2012 09:50:52
*
Debugout called from DEBUGDOC at line 3: about to open database
Debugout called from DEBUGDOC at line 5: about to open table
Debugout called from DEBUGDOC at line 8: after replace
Debugout called from DEBUGDOC at line 10: after close data