Trace (XmlDoc/XmlNode subroutine): Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "<span style="font-size:120%; color:black"><b>Display selected subtree on Trace stream</b></span> Trace subroutine [[Category:XmlNode methods|Trace sub...")
 
mNo edit summary
 
(22 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<span style="font-size:120%; color:black"><b>Display selected subtree on Trace stream</b></span>
{{Template:XmlDoc/XmlNode:Trace subtitle}}
[[Category:XmlDoc methods|Trace subroutine]]
<var>Trace</var> displays an <var>XmlDoc</var> subtree in a readable form, useful for debugging, for example.  <var>Trace</var> is identical to <var>[[Print (XmlDoc/XmlNode subroutine)|Print]]</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 <var class="product">User Language</var> <var>[[Trace statement|Trace]]</var> statement). Also, the default indentation for <var>Trace</var> is one space, while the default for the <var>Print</var> method is three.
[[Category:XmlNode methods|Trace subroutine]]
[[Category:XmlDoc API methods]]
[[Category:System methods]]
<!--DPL?? Category:XmlDoc methods|Trace subroutine: Display selected subtree on Trace stream-->
<!--DPL?? Category:XmlNode methods|Trace subroutine: Display selected subtree on Trace stream-->
<!--DPL?? Category:XmlDoc API methods|Trace (XmlDoc/XmlNode subroutine): Display selected subtree on Trace stream-->
<!--DPL?? Category:System methods|Trace (XmlDoc/XmlNode subroutine): Display selected subtree on Trace stream-->
<p>
Trace is a member of the [[XmlDoc class|XmlDoc]] and [[XmlNode class|XmlNode]] classes.
</p>


This subroutine displays an XmlDoc subtree in a readable form,
The default <var>Trace</var> statement stream is the terminal, so unless you reset the [[ULTRACE parameter|ULTRACE]] parameter to select another stream, <var>Trace</var> is the same as using <var>Print</var>.
useful for debugging, for example.
Trace is identical to the Print method (??[[Print (XmlDoc/XmlNode subroutine)|Print]]),
except the result is sent to the selected Trace stream
(like the User Language Trace statement), and the default indentation is one
space instead of three.


The default Trace stream is the terminal, so unless you
==Syntax==
reset the ULTRACE parameter to select another stream,
{{Template:XmlDoc/XmlNode:Trace syntax}}
Trace is the same as using the Print method.
For more information about the Trace statement, see the [[SirFact]]R..


This method is new in ''Sirius Mods'' version 6.7.
==See also==
===Syntax===
<ul>
  Call nr:Trace([Xpath], [options])
<li>The <var>[[Audit (XmlDoc/XmlNode subroutine)|Audit]]</var> subroutine
<li>The <var>[[Print (XmlDoc/XmlNode subroutine)|Print]]</var> subroutine
</ul>
{{Template:XmlDoc/XmlNode:Trace footer}}

Latest revision as of 20:33, 10 October 2012

Display selected subtree on Trace stream (XmlDoc and XmlNode classes)

Trace displays an XmlDoc subtree in a readable form, useful for debugging, for example. Trace is identical to Print, 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.

Syntax

nr:Trace[( [xpath], [options])] Throws XPathError

See also