Welcome!

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

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
The Internet of Things (IoT) is going to require a new way of thinking and of developing software for speed, security and innovation. This requires IT leaders to balance business as usual while anticipating for the next market and technology trends. Cloud provides the right IT asset portfolio to help today’s IT leaders manage the old and prepare for the new. Today the cloud conversation is evolving from private and public to hybrid. This session will provide use cases and insights to reinforce the value of the network in helping organizations to maximize their company’s cloud experience.
Cultural, regulatory, environmental, political and economic (CREPE) conditions over the past decade are creating cross-industry solution spaces that require processes and technologies from both the Internet of Things (IoT), and Data Management and Analytics (DMA). These solution spaces are evolving into Sensor Analytics Ecosystems (SAE) that represent significant new opportunities for organizations of all types. Public Utilities throughout the world, providing electricity, natural gas and water, are pursuing SmartGrid initiatives that represent one of the more mature examples of SAE. We have spoken with, or attended presentations from, utilities in the United States, South America, Asia and Europe. This session will provide a look at the CREPE drivers for SmartGrids and the solution spaces used by SmartGrids today and planned for the near future. All organizations can learn from SmartGrid’s use of Predictive Maintenance, Demand Prediction, Cloud, Big Data and Customer-facing Dashboards...
IoT is still a vague buzzword for many people. In his session at Internet of @ThingsExpo, Mike Kavis, Vice President & Principal Cloud Architect at Cloud Technology Partners, will discuss the business value of IoT that goes far beyond the general public's perception that IoT is all about wearables and home consumer services. The presentation will also discuss how IoT is perceived by investors and how venture capitalist access this space. Other topics to discuss are barriers to success, what is new, what is old, and what the future may hold.
Whether you're a startup or a 100 year old enterprise, the Internet of Things offers a variety of new capabilities for your business. IoT style solutions can help you get closer your customers, launch new product lines and take over an industry. Some companies are dipping their toes in, but many have already taken the plunge, all while dramatic new capabilities continue to emerge. In his session at Internet of @ThingsExpo, Reid Carlberg, Senior Director, Developer Evangelism at salesforce.com, to discuss real-world use cases, patterns and opportunities you can harness today.
All major researchers estimate there will be tens of billions devices – computers, smartphones, tablets, and sensors – connected to the Internet by 2020. This number will continue to grow at a rapid pace for the next several decades. With major technology companies and startups seriously embracing IoT strategies, now is the perfect time to attend @ThingsExpo in Silicon Valley. Learn what is going on, contribute to the discussions, and ensure that your enterprise is as "IoT-Ready" as it can be!
Noted IoT expert and researcher Joseph di Paolantonio (pictured below) has joined the @ThingsExpo faculty. Joseph, who describes himself as an “Independent Thinker” from DataArchon, will speak on the topic of “Smart Grids & Managing Big Utilities.” Over his career, Joseph di Paolantonio has worked in the energy, renewables, aerospace, telecommunications, and information technology industries. His expertise is in data analysis, system engineering, Bayesian statistics, data warehouses, business intelligence, data mining, predictive methods, and very large databases (VLDB). Prior to DataArchon, he served as a VP and Principal Analyst with Constellation Group. He is a member of the Boulder (Colo.) Brain Trust, an organization with a mission “to benefit the Business Intelligence and data management industry by providing pro bono exchange of information between vendors and independent analysts on new trends and technologies and to provide vendors with constructive feedback on their of...
Software AG helps organizations transform into Digital Enterprises, so they can differentiate from competitors and better engage customers, partners and employees. Using the Software AG Suite, companies can close the gap between business and IT to create digital systems of differentiation that drive front-line agility. We offer four on-ramps to the Digital Enterprise: alignment through collaborative process analysis; transformation through portfolio management; agility through process automation and integration; and visibility through intelligent business operations and big data.
There will be 50 billion Internet connected devices by 2020. Today, every manufacturer has a propriety protocol and an app. How do we securely integrate these "things" into our lives and businesses in a way that we can easily control and manage? Even better, how do we integrate these "things" so that they control and manage each other so our lives become more convenient or our businesses become more profitable and/or safe? We have heard that the best interface is no interface. In his session at Internet of @ThingsExpo, Chris Matthieu, Co-Founder & CTO at Octoblu, Inc., will discuss how these devices generate enough data to learn our behaviors and simplify/improve our lives. What if we could connect everything to everything? I'm not only talking about connecting things to things but also systems, cloud services, and people. Add in a little machine learning and artificial intelligence and now we have something interesting...
Last week, while in San Francisco, I used the Uber app and service four times. All four experiences were great, although one of the drivers stopped for 30 seconds and then left as I was walking up to the car. He must have realized I was a blogger. None the less, the next car was just a minute away and I suffered no pain. In this article, my colleague, Ved Sen, Global Head, Advisory Services Social, Mobile and Sensors at Cognizant shares his experiences and insights.
We are reaching the end of the beginning with WebRTC and real systems using this technology have begun to appear. One challenge that faces every WebRTC deployment (in some form or another) is identity management. For example, if you have an existing service – possibly built on a variety of different PaaS/SaaS offerings – and you want to add real-time communications you are faced with a challenge relating to user management, authentication, authorization, and validation. Service providers will want to use their existing identities, but these will have credentials already that are (hopefully) irreversibly encoded. In his session at Internet of @ThingsExpo, Peter Dunkley, Technical Director at Acision, will look at how this identity problem can be solved and discuss ways to use existing web identities for real-time communication.
Can call centers hang up the phones for good? Intuitive Solutions did. WebRTC enabled this contact center provider to eliminate antiquated telephony and desktop phone infrastructure with a pure web-based solution, allowing them to expand beyond brick-and-mortar confines to a home-based agent model. It also ensured scalability and better service for customers, including MUY! Companies, one of the country's largest franchise restaurant companies with 232 Pizza Hut locations. This is one example of WebRTC adoption today, but the potential is limitless when powered by IoT. Attendees will learn real-world benefits of WebRTC and explore future possibilities, as WebRTC and IoT intersect to improve customer service.
From telemedicine to smart cars, digital homes and industrial monitoring, the explosive growth of IoT has created exciting new business opportunities for real time calls and messaging. In his session at Internet of @ThingsExpo, Ivelin Ivanov, CEO and Co-Founder of Telestax, will share some of the new revenue sources that IoT created for Restcomm – the open source telephony platform from Telestax. Ivelin Ivanov is a technology entrepreneur who founded Mobicents, an Open Source VoIP Platform, to help create, deploy, and manage applications integrating voice, video and data. He is the co-founder of TeleStax, an Open Source Cloud Communications company that helps the shift from legacy IN/SS7 telco networks to IP-based cloud comms. An early investor in multiple start-ups, he still finds time to code for his companies and contribute to open source projects.
The Internet of Things (IoT) promises to create new business models as significant as those that were inspired by the Internet and the smartphone 20 and 10 years ago. What business, social and practical implications will this phenomenon bring? That's the subject of "Monetizing the Internet of Things: Perspectives from the Front Lines," an e-book released today and available free of charge from Aria Systems, the leading innovator in recurring revenue management.
The Internet of Things will put IT to its ultimate test by creating infinite new opportunities to digitize products and services, generate and analyze new data to improve customer satisfaction, and discover new ways to gain a competitive advantage across nearly every industry. In order to help corporate business units to capitalize on the rapidly evolving IoT opportunities, IT must stand up to a new set of challenges.
There’s Big Data, then there’s really Big Data from the Internet of Things. IoT is evolving to include many data possibilities like new types of event, log and network data. The volumes are enormous, generating tens of billions of logs per day, which raise data challenges. Early IoT deployments are relying heavily on both the cloud and managed service providers to navigate these challenges. In her session at 6th Big Data Expo®, Hannah Smalltree, Director at Treasure Data, to discuss how IoT, Big Data and deployments are processing massive data volumes from wearables, utilities and other machines.
P2P RTC will impact the landscape of communications, shifting from traditional telephony style communications models to OTT (Over-The-Top) cloud assisted & PaaS (Platform as a Service) communication services. The P2P shift will impact many areas of our lives, from mobile communication, human interactive web services, RTC and telephony infrastructure, user federation, security and privacy implications, business costs, and scalability. In his session at Internet of @ThingsExpo, Erik Lagerway, Co-founder of Hookflash, will walk through the shifting landscape of traditional telephone and voice services to the modern P2P RTC era of OTT cloud assisted services.
While great strides have been made relative to the video aspects of remote collaboration, audio technology has basically stagnated. Typically all audio is mixed to a single monaural stream and emanates from a single point, such as a speakerphone or a speaker associated with a video monitor. This leads to confusion and lack of understanding among participants especially regarding who is actually speaking. Spatial teleconferencing introduces the concept of acoustic spatial separation between conference participants in three dimensional space. This has been shown to significantly improve comprehension and conference efficiency.
The Internet of Things is tied together with a thin strand that is known as time. Coincidentally, at the core of nearly all data analytics is a timestamp. When working with time series data there are a few core principles that everyone should consider, especially across datasets where time is the common boundary. In his session at Internet of @ThingsExpo, Jim Scott, Director of Enterprise Strategy & Architecture at MapR Technologies, will discuss single-value, geo-spatial, and log time series data. By focusing on enterprise applications and the data center, he will use OpenTSDB as an example to explain some of these concepts including when to use different storage models.
SYS-CON Events announced today that Gridstore™, the leader in software-defined storage (SDS) purpose-built for Windows Servers and Hyper-V, will exhibit at SYS-CON's 15th International Cloud Expo®, which will take place on November 4–6, 2014, at the Santa Clara Convention Center in Santa Clara, CA. Gridstore™ is the leader in software-defined storage purpose built for virtualization that is designed to accelerate applications in virtualized environments. Using its patented Server-Side Virtual Controller™ Technology (SVCT) to eliminate the I/O blender effect and accelerate applications Gridstore delivers vmOptimized™ Storage that self-optimizes to each application or VM across both virtual and physical environments. Leveraging a grid architecture, Gridstore delivers the first end-to-end storage QoS to ensure the most important App or VM performance is never compromised. The storage grid, that uses Gridstore’s performance optimized nodes or capacity optimized nodes, starts with as few a...
The Transparent Cloud-computing Consortium (abbreviation: T-Cloud Consortium) will conduct research activities into changes in the computing model as a result of collaboration between "device" and "cloud" and the creation of new value and markets through organic data processing High speed and high quality networks, and dramatic improvements in computer processing capabilities, have greatly changed the nature of applications and made the storing and processing of data on the network commonplace. These technological reforms have not only changed computers and smartphones, but are also changing the data processing model for all information devices. In particular, in the area known as M2M (Machine-To-Machine), there are great expectations that information with a new type of value can be produced using a variety of devices and sensors saving/sharing data via the network and through large-scale cloud-type data processing. This consortium believes that attaching a huge number of devic...