MACROMEDIA COLFUSION MX 7-CFML Reference page 425

Attribute Req/Opt Default
type Optional
var Optional
Usage
You cannot put application code within this tag. (This avoids problems that can occur if you
disable debugging.)
This tag is useful for debugging CFML code during application development.
You can display
cftrace
•
As a section in the debugging output
•
In-line in an application page, and as a section in debugging output. If you specify in-line
tracing, ColdFusion flushes all output up to the
when it encounters the tag.
This is an example of a log file entry:
"Information","web-4","04/08/02","23:21:30",
[C:\CFusionMX7\wwwroot\generic.cfm @ line: 9] -
[thisPage = /generic.cfm]
"Information","web-0","04/08/02","23:58:58",
[C:\CFusionMX7\wwwroot\generic.cfm @ line: 14] - [category]
[thisPage = /generic.cfm] [ABORTED] thisPage "
For a complex variable, ColdFusion lists the variable name and the number of elements in the
object; it does not log the contents of the variable.
Example
The following example traces a FORM variable that is evaluated by a
<cftrace var="FORM.variable"
text="doing equivalency check for FORM.variable"
category="form_vars"
inline="true">
<cfif isDefined("FORM.variable") AND #FORM.variable# EQ 1>
<h1>Congratulations, you're a winner!</h1>
<cfelse>
<h1>Sorry, you lost!</h1>
</cfif>
Description
Information Corresponds to the
appropriate icon:
• Information
• Warning
• Error
• Fatal Information
The name of a simple or complex variable to display.
Useful for displaying a temporary value, or a value that does
not display on any CFM page.
tag output in the following ways:
"
attribute; displays an
cflog type
tag, and displays the trace output
cftrace
,"[30 ms (1st trace)]
,"[5187 ms (10)]
cfif
block:
cftrace 425