Welcome!

You will be redirected in 30 seconds or close now.

ColdFusion Authors: Yakov Fain, Jeremy Geelan, Maureen O'Gara, Nancy Y. Nee, Tad Anderson

Related Topics: ColdFusion

ColdFusion: Article

Making Decisions in Your Code with ColdFusion "cfif"

Before you can implement conditional logic in your code you have to understand what conditional logic is

This month I will examine the cfif tag and discuss how we can use that tag to make decisions in our code. Along the way I'll talk about Boolean logic, decision operators, and Boolean operators in CFML.

Understanding Conditional Logic
Before you can implement conditional logic in your code you have to understand what conditional logic is. I have no doubt that every one of you knows what conditional logic is, although you may never have heard it referred to as such. Conditional logic is just a fancy way of saying that you are going to make a decision. Usually the decision is based upon some sort of condition or the result of an operation.

You and I make decisions every day, so let's delve into some real-world examples. Suppose I'm driving a car and come to an intersection with another road. I need to make a decision whether to turn left, turn right, or continue straight on the main road. Each decision may have different consequences. If I turn right, I go to the bank. If I turn left, I go to the grocery store. Going straight might take me somewhere else, home, for example. Since it has been a long day, I want to go home. I'm going to drive straight. This is an example of conditional logic in practice. I made a choice to go straight, based on a condition, I want to go home, and something happened as a result of that condition.

Making decisions about groceries and the bank is all well and good, but how does this apply to Web development? I'm glad you asked. Suppose you have a sign-up form on your Web site. Your users enter some account information, such as an e-mail address, their name, a username, and password. You take that information and create a user account in your database.

What happens if the user does not enter a username? Can you still create the account? How do you handle that situation? You can use conditional logic to make sure that the username is not left blank. Suppose a user looks at the shopping cart before adding items to it? You can use conditional logic to display an "empty cart" message. Suppose a user enters a birth date as November 15, 2050? You get the idea - we can use conditional logic in our code to solve these types of problems.

The Format of the cfif Tag
In CFML, you can use the cfif tag to perform conditional logic statements. It comes in this format:

<cfif expression>
Perform Actions
</cfif>

The cfif tag is an oddball tag in the CFML language. Unlike most tags, it doesn't take any explicit parameter name and value arguments; it is simply followed by an expression after the tag name. A review of expressions can be found in last month's article; or you can go straight to the source: http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/cfml_b14.htm. The CFML interpreter uses an expression to determine whether or not to process data. Expressions are literal values, variables, or functions (which return a Boolean value).

The expression inside the cfif tag must evaluate to a Boolean value (a true/false). Boolean values are represented as either "true" or "false", "yes" or "no", or "0" or any number. If the expression evaluates to true, then the action immediately following the <cfif> is performed. If the expression evaluates to false, then the action is not performed and template execution will continue after the end cfif tag. There are two types of operators that are used with cfif tags: decision operators and Boolean operators. Both evaluate to Boolean values.

Decision and Boolean Operators
The two types of operators used in a cfif expression are decision operators and Boolean operators. Boolean operators refer to specific operators from Boolean algebra. Decision operators are used for comparisons. This is a list of the Boolean and decision operators supported in CFML:

  • NOT: A Boolean operator that returns the opposite of the specified expressions. If you want the NOT of true, then you get false. The NOT of false is true.
  • AND: A Boolean operator that returns true if both operands are true, but false otherwise.
  • OR: A Boolean operator that returns true if at least one of the operands is true, but returns false otherwise.
  • XOR: A Boolean operator that performs an exclusive or. If only one of the values is true, then the result is true. Otherwise the result is false.
  • EQV: A Boolean operator that performs equivalence. Returns true if both operands are true or both operands are false. Returns false if the operands are different.
  • IMP: A Boolean operator that performs implication. It is akin to the logical statement "If condition 1, then condition 2." This returns false if condition 1 is true and condition 2 is false. True is returned in all other cases.
  • IS, EQUAL, EQ: Decision operators that test for two values being equal. If the first value is equal to the second value, the final result is true.
  • IS NOT, NOT EQUAL, NEQ: Decision operators that test for two values not being equal. If the two values are equal, then the final result will be false.
  • GREATER THAN, GT: Decision operators that are used to check if the first value is greater than the second value.
  • GREATER THAN OR EQUAL TO, GTE, GE: Decision operators that check to see if the first value is larger than or equal to the second value.
  • LESS THAN, LT: Decision operators that are used to check if the first value is smaller than the second value.
  • LESS THAN OR EQUAL TO, LTE, LE: Decision operators that check to see if the first value is smaller than or equal to the second value.
  • CONTAINS: A decision operator that returns true if the value on the left contains the value on the right.
  • DOES NOT CONTAIN: A decision operator that returns true if the value on the left does not contain the value on the right.

You can read more about decision operators in the Macromedia Livedocs at http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/expresa6.htm and about Boolean operators at http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/expresa5.htm.

It is worth noting the order in which these operations are applied. This builds right off the order of operations I discussed in last month's article. First, the arithmetic operators are applied, and then the string operator is applied. Following that, the decision operators are applied: EQ, NEQ, LT, LTE, GT, GTE, CONTAINS, DOES NOT CONTAIN from left to right in the order that they appear. Then come the Boolean operators. First the NOT operator is applied, then the AND operator. Then the OR operator, followed by the XOR operator. Next comes EQV, and finally, IMP. You can always use parentheses to change the order of operations. In fact, when in doubt, use parentheses to force the order of operations! In most cases you won't be mixing arithmetic or string operands with decision or Boolean ones; however, decision and Boolean operands are often used together. Let me show you how to put this into practice.

Take Some Code for a Test Drive
Suppose you want to make a simple interface for users to choose which way to turn their car. This sample uses an HTML form to collect the user input, as shown below. If you are unfamiliar with HTML forms, I found some great Web-based tutorials located at www.weballey.net/forms and www.wdvl.com/Authoring/Scripting/Tutorial/html_forms_intro.html.

<form action="Go.cfm" method="post">
<input type="Radio" name="Route" value="Right">Right
<input type="Radio" name="Route" value="Left">Left
<input type="Radio" name="Route" value="Straight">Straight<Br>
<input type="submit">
</form>

The form uses radio buttons to let the user select a direction and then click Submit to see the result page:

<cfif Route is "Right">
Go to Bank<br>
</cfif>
<cfif Route is "Left">
Go to Store<br>
</cfif>
<cfif Route is "Straight">
Go Home<br>
</cfif>

If you copy this code to see the example in action, make sure that you put it in a file named go.cfm and put both files in the same directory. This code uses the decision operator IS to determine the value of Route. It uses multiple cfif tags to figure out the value of the Route variable and what it should be.

Specifying Additional Conditions with cfelse and cfelseif
Up to this point the cfif tags have performed actions only if an expression resulted to true. What happens when you need to perform some actions when a condition is false? Well, you could use the NOT operator to create a second cfif statement, but there is a better way. CFML offers us the <cfelse> tag. This is the syntax:

<cfif expression>
Perform Actions
<cfelse>
Perform Other Actions
</cfif>

The cfif tag remains the same, as do the actions that we perform if the condition is true. What changes is that we have a cfelse tag. The cfelse tag does not take any parameters or expressions - it simply offers the alternative code to run in case a cfif evaluates to false.

If you go back to the driving example, you will see that we have three separate conditions. Turning left directs us to the grocery store, turning right takes us to the bank, and going straight sends us home. In this case, it won't be possible to perform all of the actions at once. Our first example is inefficient because we evaluate all conditions even after finding the correct one.

There is a better way to handle this situation - through the use of a tag called cfelseif. The cfelseif tag allows us to add multiple conditions to our cfif statement. If the first condition does not evaluate to true, then the second cfelseif condition is evaluated. If the second is not true, then the third is evaluated. Use of the cfelseif is optional, and there is no limit to the number of cfelseif conditions you can have. By contrast, the cfelse tag can be used only once. This is the syntax for cfelseif:

<cfif expression>
Perform Actions
<cfelseif expression2>
Perform Other Actions
</cfif>

The code is very similar to the previous sample. The cfelseif tag contains an additional expression, whereas the cfelse did not. It will be evaluated only if the cfif expression is false. When there are cfelseif tags and a cfelse tag, the cfelse tag must always come last (after all cfelseif tags). The previous example used multiple cfif tags. The cfelseif tag lets us combine the separate cfif tags into a single login. This is the code:

<cfif Route is "Right">
Go to Bank<br>
<cfelseif Route is "Left">
Go to Store<br>
<cfelse>
Go Home<br>
</cfif>

If the route chosen is right, then we go to the bank. If the route is left we go to the store. If nothing else, we continue to go straight on home.

Where Do I Go from Here?
The cfif statement can get very complicated if you start using one cfif statement inside another cfif statement. If you want to do some independent study, I would suggest reading up on cfswitch at http://livedocs.macromedia.com/coldfusion/ 6.1/htmldocs/tags-c10.htm#wp1103819 and cfcase at http://livedocs.macromedia.com/coldfusion/ 6.1/htmldocs/tags-pa9.htm#wp2664410. They are used together to form case statements, which are a different form of conditionals that you can use in your code. The use of cfswitch and cfcase statements is often a great way to simplify complex cfif.

It has been a pleasure writing these articles for you, and I'm pleased to announce that I've received my first topic request. Next month I will be writing about structures and arrays. Keep the ideas coming!

More Stories By Jeffry Houser

Jeffry is a technical entrepreneur with over 10 years of making the web work for you. Lately Jeffry has been cooped up in his cave building the first in a line of easy to use interface components for Flex Developers at www.flextras.com . He has a Computer Science degree from the days before business met the Internet and owns DotComIt, an Adobe Solutions Partner specializing in Rich Internet Applications. Jeffry is an Adobe Community Expert and produces The Flex Show, a podcast that includes expert interviews and screencast tutorials. Jeffry is also co-manager of the Hartford CT Adobe User Group, author of three ColdFusion books and over 30 articles, and has spoken at various events all over the US. In his spare time he is a musician, old school adventure game aficionado, and recording engineer. He also owns a Wii. You can read his blog at www.jeffryhouser.com, check out his podcast at www.theflexshow.com or check out his company at www.dot-com-it.com.

Comments (7) View Comments

Share your thoughts on this story.

Add your comment
You must be signed in to add a comment. Sign-in | Register

In accordance with our Comment Policy, we encourage comments that are on topic, relevant and to-the-point. We will remove comments that include profanity, personal attacks, racial slurs, threats of violence, or other inappropriate material that violates our Terms and Conditions, and will block users who make repeated violations. We ask all readers to expect diversity of opinion and to treat one another with dignity and respect.


Most Recent Comments
CFDJ News Desk 12/04/05 02:00:18 AM EST

Making Decisions in Your Code with ColdFusion "cfif". This month I will examine the cfif tag and discuss how we can use that tag to make decisions in our code. Along the way I'll talk about Boolean logic, decision operators, and Boolean operators in CFML.

SYS-CON Canada News Desk 12/03/05 11:19:15 AM EST

Making Decisions in Your Code with "cfif" This month I will examine the cfif tag and discuss how we can use that tag to make decisions in our code. Along the way I'll talk about Boolean logic, decision operators, and Boolean operators in CFML.

CFDJ News Desk 12/03/05 10:50:59 AM EST

Making Decisions in Your Code with "cfif"
This month I will examine the cfif tag and discuss how we can use that tag to make decisions in our code. Along the way I'll talk about Boolean logic, decision operators, and Boolean operators in CFML.

Jeff Houser 11/14/05 12:35:24 PM EST

Hi Kevin,
I just saw your comment now. I'm glad you like the articles.

The type of security I wrote about in the "Remember Me" article (August 2004) is still what I use today. I find that, in most cases, the web applications I've worked on did not need anything more advanced than that.

I dealt with Lotus Notes a lot right out of college (a while ago) and their security scheme is the most powerful/flexible I've ever seen.

In my first book, (Instant Coldfusion now extremely dated), I wrote about implementing this sort of system in CF, but it is overkill for most web apps.

I'll keep a "Back to basics" article in mind, although these days I try to tie in with the issue focus.

Jeff Houser 11/14/05 12:34:57 PM EST

Hi Kevin,
I just saw your comment now. I'm glad you like the articles.

The type of security I wrote about in the "Remember Me" article (August 2004) is still what I use today. I find that, in most cases, the web applications I've worked on did not need anything more advanced than that.

I dealt with Lotus Notes a lot right out of college (a while ago) and their security scheme is the most powerful/flexible I've ever seen.

In my first book, (Instant Coldfusion now extremely dated), I wrote about implementing this sort of system in CF, but it is overkill for most web apps.

I'll keep a "Back to basics" article in mind, although these days I try to tie in with the issue focus.

CFDJ News Desk 10/20/05 09:51:59 PM EDT

ColdFusion Developer's Journal - Making Decisions in Your Code with "cfif" This month I will examine the cfif tag and discuss how we can use that tag to make decisions in our code. Along the way I'll talk about Boolean logic, decision operators, and Boolean operators in CFML.

Kevin 10/20/05 09:25:55 PM EDT

I like your articles quite a bit!

I was wondering what your current take on home-spun user security is now that we are almost in 2006 and your article about remembering user logins was 2004 if I remember correctly...

Have you got any thoughts on more complex role based models vs privilage based? etc...

I'd like to here your thoughst on this.

Also, it's old news, but I download applications from what i would have though to be good cfml-ers that still use #'s where the should not! a nice back to basics article might be good for specificly when to use and not use #'s

thanks!

Kevin

@ThingsExpo Stories
"Once customers get a year into their IoT deployments, they start to realize that they may have been shortsighted in the ways they built out their deployment and the key thing I see a lot of people looking at is - how can I take equipment data, pull it back in an IoT solution and show it in a dashboard," stated Dave McCarthy, Director of Products at Bsquare Corporation, in this SYS-CON.tv interview at @ThingsExpo, held November 1-3, 2016, at the Santa Clara Convention Center in Santa Clara, CA.
The cloud promises new levels of agility and cost-savings for Big Data, data warehousing and analytics. But it’s challenging to understand all the options – from IaaS and PaaS to newer services like HaaS (Hadoop as a Service) and BDaaS (Big Data as a Service). In her session at @BigDataExpo at @ThingsExpo, Hannah Smalltree, a director at Cazena, provided an educational overview of emerging “as-a-service” options for Big Data in the cloud. This is critical background for IT and data professionals...
Fact is, enterprises have significant legacy voice infrastructure that’s costly to replace with pure IP solutions. How can we bring this analog infrastructure into our shiny new cloud applications? There are proven methods to bind both legacy voice applications and traditional PSTN audio into cloud-based applications and services at a carrier scale. Some of the most successful implementations leverage WebRTC, WebSockets, SIP and other open source technologies. In his session at @ThingsExpo, Da...
As data explodes in quantity, importance and from new sources, the need for managing and protecting data residing across physical, virtual, and cloud environments grow with it. Managing data includes protecting it, indexing and classifying it for true, long-term management, compliance and E-Discovery. Commvault can ensure this with a single pane of glass solution – whether in a private cloud, a Service Provider delivered public cloud or a hybrid cloud environment – across the heterogeneous enter...
"IoT is going to be a huge industry with a lot of value for end users, for industries, for consumers, for manufacturers. How can we use cloud to effectively manage IoT applications," stated Ian Khan, Innovation & Marketing Manager at Solgeniakhela, in this SYS-CON.tv interview at @ThingsExpo, held November 3-5, 2015, at the Santa Clara Convention Center in Santa Clara, CA.
Today we can collect lots and lots of performance data. We build beautiful dashboards and even have fancy query languages to access and transform the data. Still performance data is a secret language only a couple of people understand. The more business becomes digital the more stakeholders are interested in this data including how it relates to business. Some of these people have never used a monitoring tool before. They have a question on their mind like “How is my application doing” but no id...
@GonzalezCarmen has been ranked the Number One Influencer and @ThingsExpo has been named the Number One Brand in the “M2M 2016: Top 100 Influencers and Brands” by Onalytica. Onalytica analyzed tweets over the last 6 months mentioning the keywords M2M OR “Machine to Machine.” They then identified the top 100 most influential brands and individuals leading the discussion on Twitter.
Information technology is an industry that has always experienced change, and the dramatic change sweeping across the industry today could not be truthfully described as the first time we've seen such widespread change impacting customer investments. However, the rate of the change, and the potential outcomes from today's digital transformation has the distinct potential to separate the industry into two camps: Organizations that see the change coming, embrace it, and successful leverage it; and...
The Internet of Things (IoT) promises to simplify and streamline our lives by automating routine tasks that distract us from our goals. This promise is based on the ubiquitous deployment of smart, connected devices that link everything from industrial control systems to automobiles to refrigerators. Unfortunately, comparatively few of the devices currently deployed have been developed with an eye toward security, and as the DDoS attacks of late October 2016 have demonstrated, this oversight can ...
Extracting business value from Internet of Things (IoT) data doesn’t happen overnight. There are several requirements that must be satisfied, including IoT device enablement, data analysis, real-time detection of complex events and automated orchestration of actions. Unfortunately, too many companies fall short in achieving their business goals by implementing incomplete solutions or not focusing on tangible use cases. In his general session at @ThingsExpo, Dave McCarthy, Director of Products...
Machine Learning helps make complex systems more efficient. By applying advanced Machine Learning techniques such as Cognitive Fingerprinting, wind project operators can utilize these tools to learn from collected data, detect regular patterns, and optimize their own operations. In his session at 18th Cloud Expo, Stuart Gillen, Director of Business Development at SparkCognition, discussed how research has demonstrated the value of Machine Learning in delivering next generation analytics to impr...
More and more brands have jumped on the IoT bandwagon. We have an excess of wearables – activity trackers, smartwatches, smart glasses and sneakers, and more that track seemingly endless datapoints. However, most consumers have no idea what “IoT” means. Creating more wearables that track data shouldn't be the aim of brands; delivering meaningful, tangible relevance to their users should be. We're in a period in which the IoT pendulum is still swinging. Initially, it swung toward "smart for smar...
20th Cloud Expo, taking place June 6-8, 2017, at the Javits Center in New York City, NY, will feature technical sessions from a rock star conference faculty and the leading industry players in the world. Cloud computing is now being embraced by a majority of enterprises of all sizes. Yesterday's debate about public vs. private has transformed into the reality of hybrid cloud: a recent survey shows that 74% of enterprises have a hybrid cloud strategy.
Businesses and business units of all sizes can benefit from cloud computing, but many don't want the cost, performance and security concerns of public cloud nor the complexity of building their own private clouds. Today, some cloud vendors are using artificial intelligence (AI) to simplify cloud deployment and management. In his session at 20th Cloud Expo, Ajay Gulati, Co-founder and CEO of ZeroStack, will discuss how AI can simplify cloud operations. He will cover the following topics: why clou...
Internet of @ThingsExpo, taking place June 6-8, 2017 at the Javits Center in New York City, New York, is co-located with the 20th International Cloud Expo and will feature technical sessions from a rock star conference faculty and the leading industry players in the world. @ThingsExpo New York Call for Papers is now open.
"ReadyTalk is an audio and web video conferencing provider. We've really come to embrace WebRTC as the platform for our future of technology," explained Dan Cunningham, CTO of ReadyTalk, in this SYS-CON.tv interview at WebRTC Summit at 19th Cloud Expo, held November 1-3, 2016, at the Santa Clara Convention Center in Santa Clara, CA.
Successful digital transformation requires new organizational competencies and capabilities. Research tells us that the biggest impediment to successful transformation is human; consequently, the biggest enabler is a properly skilled and empowered workforce. In the digital age, new individual and collective competencies are required. In his session at 19th Cloud Expo, Bob Newhouse, CEO and founder of Agilitiv, drew together recent research and lessons learned from emerging and established compa...
Data is the fuel that drives the machine learning algorithmic engines and ultimately provides the business value. In his session at Cloud Expo, Ed Featherston, a director and senior enterprise architect at Collaborative Consulting, discussed the key considerations around quality, volume, timeliness, and pedigree that must be dealt with in order to properly fuel that engine.
Everyone knows that truly innovative companies learn as they go along, pushing boundaries in response to market changes and demands. What's more of a mystery is how to balance innovation on a fresh platform built from scratch with the legacy tech stack, product suite and customers that continue to serve as the business' foundation. In his General Session at 19th Cloud Expo, Michael Chambliss, Head of Engineering at ReadyTalk, discussed why and how ReadyTalk diverted from healthy revenue and mor...
We are always online. We access our data, our finances, work, and various services on the Internet. But we live in a congested world of information in which the roads were built two decades ago. The quest for better, faster Internet routing has been around for a decade, but nobody solved this problem. We’ve seen band-aid approaches like CDNs that attack a niche's slice of static content part of the Internet, but that’s it. It does not address the dynamic services-based Internet of today. It does...