MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 187 / 806

cfif 187
cfif
Description
Creates simple and compound conditional statements in CFML. Tests an expression, variable,
function return value, or string. Used, optionally, with the
cfelse
and
cfelseif
tags.
Category
Flow-control tags
Syntax
<cfif expression>
HTML and CFML tags
<cfelseif expression>
HTML and CFML tags
<cfelse>
HTML and CFML tags
</cfif>
See also
cfelse , cfelseif , cfabort , cfbreak , cfexecute , cfexit , cflocation , cfloop ,
cfswitch , cfthrow , cftry
Usage
If the value of the expression in the
cfif
tag is True, ColdFusion processes all the code that
follows, up to any
cfelseif
or
cfelse
tag, and then skips to the
cfif
end tag. Otherwise,
ColdFusion does not process the code that immediately follows the
cfif
tag, and continues
processing at any
cfelseif
or
cfelse
tag, or with the code that follows the
cfif
end tag.
When testing the return value of a function that returns a Boolean, you do not have to define the
True condition explicitly. This example uses the
IsArray
function:
<cfif IsArray(myarray)>
If successful,
IsArray
evaluates to Yes, the string equivalent of the Boolean True. This is preferred
over explicitly defining the True condition this way:
<cfif IsArray(myarray) IS True>
This tag requires an end tag.
Example
In this example, variables are shown within pound signs. This is not required.
<!--- This example shows the interaction of cfif, cfelse, and cfelseif --->
<!----- first, perform a query to get some data ----->
<cfquery name="getCenters" datasource="cfsnippets">
SELECT Center_ID, Name, Address1, Address2, City, State, Country,
PostalCode, Phone, Contact
FROM Centers
ORDER by City, State, Name
</cfquery>
<p>CFIF gives us the ability to perform conditional logic based on a condition
or set of conditions.
<p>For example, we can output the list of Centers from the snippets datasource
by group and only display them <b>IF</b> City = San Diego.
<hr>
<!---- use CFIF to test a condition when outputting a query ----->
<p>The following centers are in San Diego:
<cfoutput query="getCenters">