Description

A conditional loop iterates over a set of instructions as long as a condition is True. To use this type of loop correctly, the instructions must change the condition every time the loop iterates, until the condition is False. Conditional loops are known as WHILE loops, as in, "loop WHILE this condition is true."

Syntax

<cfloop 
condition = "expression"> 
... 
</cfloop>

See also

cfabortcfbreakcfcontinuecfexecutecfexitcfifcflocationcfswitchcfthrowcftrycfloop and cfbreak in the Developing ColdFusion Applications

Attributes

Attribute

Req/Opt

Default

Description

condition

Required

 

Condition that controls the loop.

Example

The following example increments CountVar from 1 to 5.

 

<!--- Set the variable CountVar to 0. ---> 
<cfset CountVar = 0> 
<!--- Loop until CountVar = 5. ---> 
<cfloop condition = "CountVar LESS THAN 5"> 
<cfset CountVar = CountVar + 1> 
    The loop index is <cfoutput>#CountVar#</cfoutput>.<br> 
</cfloop>

The output of this loop is as follows:

The loop index is 1. 
The loop index is 2. 
The loop index is 3. 
The loop index is 4. 
The loop index is 5.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy