User Guide

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">