SET DEBUGOUT

From Lianjapedia
Jump to: navigation, search

Purpose

Enable or disable debugout logging

Syntax

SET DEBUGOUT ON | OFF | (<expL>)

See Also

CLOSE ALTERNATE, DEBUGOUT, SET ALTERNATE, SET DEBUG, SET DEBUGCOMPILE, SET DEBUGTRACE, SET EVENTTRACKING

Description

The SET DEBUGOUT command provides the ability to enable or disable DEBUGOUT logging. 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