This library script is for inclusion in other programs and allows sophisticated logging and program debugging through use of a virtual console concept.
Please note. This document is a work in progress. There are advanced features that need usage examples. This is posted early to make REBOL users aware of this powerful logging utility. 06-May-2007
>> von/tags [one] == none >> vprint/tags "This gets displayed, the tagging symbol matches" [one] This gets displayed, the tagging symbol matches == none >> vprint/tags "This isn't displayed, the tagging does not match current logging tag" [two] == none
The v in vprint, may be thought of as both verbose and virtual.
Including these tools is simple. Just DO it.
>>do %vprint.r
or to execute this right out of the rebol.org library
>>do http://www.rebol.org/cgi-bin/cgiwrap/rebol/download-a-script.r?script-name=vprint.r
von | Turn on verbosity | /tags tags and /log tags |
voff | Turn off verbosity | /tags tags and /log tags |
vin txt | Indents starting with txt and a literal [ | /always /error and /tags tags |
vout | ends indented verbose output with a literal ] | /always /error /tags tags and /return data |
vprint | verbose print with newline | /in /out /always /error and /tags tags |
vprin | verbose print without newline | /in /out /always /error and /tags tags |
vprobe | verbose probe | /in /out /always /error /tags tags and /part amount |
v?? name | verbose display of variable name with molded value | /always /error /tags tags |
vlogclear | blanks out current verbose logfile | |
vflush | flushes current verbose printing to current log file | accepts /disk file |
>> help vprint USAGE: VPRINT data /in /out /error /always /tags ftags DESCRIPTION: verbose print VPRINT is a function value. ARGUMENTS: data -- (Type: any) REFINEMENTS: /in -- indents after printing /out -- un indents before printing. Use none so that nothing is printed /error -- like always, but adds stack trace /always -- always print, even if verbose is off /tags ftags -- only effective if one of the specified tags exist in vtags (Type: any)
This section will be updated. Two quick notes.
%vprint.r | Original author: Maxim Olivier-Adlhoch |