Trace (XmlDoc/XmlNode subroutine): Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 4: | Line 4: | ||
useful for debugging, for example. | useful for debugging, for example. | ||
<var>Trace</var> is identical to the <var>[[Print (XmlDoc/XmlNode subroutine)|Print]]</var> method, | <var>Trace</var> is identical to the <var>[[Print (XmlDoc/XmlNode subroutine)|Print]]</var> method, | ||
except the result is sent to the selected <var> | except the result is sent to the currently selected trace stream. | ||
( | That stream can be the user's standard output, the <var class="product">Model 204</var> audit trail, an internal trace table, or a combination of these (as described for the User Language <var>[[Trace statement|Trace]]</var> statement). | ||
space | Also, the default indentation for <var>Trace</var> is one | ||
space, while the default for the <var>Print</var> method is three. | |||
The default <var>Trace</var> statement stream is the terminal, so unless you | The default <var>Trace</var> statement stream is the terminal, so unless you | ||
reset the [[ULTRACE parameter|ULTRACE]] parameter to select another stream, | reset the [[ULTRACE parameter|ULTRACE]] parameter to select another stream, | ||
<var>Trace</var> is the same as using | <var>Trace</var> is the same as using <var>Print</var>. | ||
This method is new in ''Sirius Mods'' version 6.7. | This method is new in ''Sirius Mods'' version 6.7. | ||
Revision as of 00:05, 18 February 2011
Display selected subtree on Trace stream (XmlDoc and XmlNode classes)
This subroutine displays an XmlDoc subtree in a readable form,
useful for debugging, for example.
Trace is identical to the Print method,
except the result is sent to the currently selected trace stream.
That stream can be the user's standard output, the Model 204 audit trail, an internal trace table, or a combination of these (as described for the User Language Trace statement).
Also, the default indentation for Trace is one
space, while the default for the Print method is three.
The default Trace statement stream is the terminal, so unless you reset the ULTRACE parameter to select another stream, Trace is the same as using Print.
This method is new in Sirius Mods version 6.7.
Syntax
nr:Trace[( [xpath], [options])] Throws XPathError