matlab.io.xml.transform.Tracer Class

Namespace: matlab.io.xml.transform

Trace execution of stylesheet

Since R2022a

Description

Use the matlab.io.xml.transform.Tracer class to specify options for tracing the execution of a stylesheet. For example, you can enable tracing and specify whether to trace the stylesheet template or element execution.

When you create a matlab.io.xml.transform.Transformer object, the Tracer property on the object is an instance of the matlab.io.xml.transform.Tracer class. To specify tracing options, use this Tracer property. You cannot create an object of the matlab.io.xml.transform.Tracer class directly.

The matlab.io.xml.transform.Tracer class is a handle class.

Class Attributes

ConstructOnLoad	true
HandleCompatible	true

For information on class attributes, see Class Attributes.

Properties

Enable — Whether to trace execution of stylesheet

false or 0 (default) | true or 1

Whether to trace the execution of a stylesheet, specified as a numeric or logical 1 (true) or 0 (false). To trace execution, set Enable to true. By default, tracing is disabled.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

OutputPath — Path to file containing tracing messages

'' (default) | character vector | string scalar

Path to the file containing the tracing messages, specified as a character vector or string scalar. OutputPath can include a relative path, but the relative path must be in the current folder. Otherwise, OutputPath must include a full path. By default, MATLAB^® displays the tracing messages in the Command Window.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

TraceTemplates — Whether to trace stylesheet template execution

false or 0 (default) | true or 1

Whether to trace the stylesheet template execution, specified as a numeric or logical 1 (true) or 0 (false). If the value is true, the XML document transformer creates a message that specifies the currently executing stylesheet template.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

TraceElements — Whether to trace stylesheet element execution

false or 0 (default) | true or 1

Whether to trace the stylesheet element execution, specified as a numeric or logical 1 (true) or 0 (false). If the value is true, the XML document transformer creates a message that specifies the currently executing stylesheet element.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

TraceGeneration — Whether to trace stylesheet output

false or 0 (default) | true or 1

Whether to trace the stylesheet output, specified as a numeric or logical 1 (true) or 0 (false). If the value is true, the XML document transformer creates a message that specifies the output generated by the execution of a stylesheet.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

TraceSelection — Whether to trace stylesheet selection results

false or 0 (default) | true or 1

Whether to trace the stylesheet selection results, specified as a numeric or logical 1 (true) or 0 (false). If the value is true, the XML document transformer creates a message that specifies the result of executing a stylesheet select expression.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

Version History

Introduced in R2022a