<Var/Number> = The log file number that will be written to. If this does not exsist it will be created.
<Var/Number> = Set this value to [TRUE] / [FALSE], or their numerical equivalent of (1) / (0) respectively. Or, a variable containing one of these values.
<Value> = What is to be written to the log file.
Writes <Value> to an external file named logNNNNN.txt where NNNNN is the number specified in 'logfile # <Var/Number>'.
If logfile # = null, nothing at all will be written. This can be useful for debugging.
If append is [TRUE], then the value is added to the end of the log file.
If append is [FALSE], then the contents of the log file are replaced with <Value>.
The following might be used at the start of a 'Debug' log.
$playing.time = playing time
$fmt.playing.time = format time: $playing.time
$log.message = sprintf: fmt = 'Debug started at playing time = %s', $fmt.playing.time, null, null, null, null
write to logfile # 9999 append =[TRUE] value =$log.message
This would add the following message to the log file, 'Debug started at playing time = 12:34:56'. It would be 'added' due to 'append =[TRUE]'.
- »» Logbook Commands
- write to logfile #<Var/Number> append=<Var/Number> value=<Value>