Used only inside the cfswitch tag body. Contains code to execute when the expression specified in the cfswitch tag has one or more specific values. Note the difference in the tag and script syntax when providing multiple values for a case.

  <cfcase value="">

 case "apple":

Attribute Reference

value string

The value or values that the expression attribute of the cfswitch tag must match. To specify multiple matching values, for tag syntax, separate the values with the delimiter character; for script syntax list each on the same line. The value or values must be simple constants or constant expressions, not variables.

delimiters string
Default: ,

Specifies the delimiter character or characters that separate multiple values to match. If you specify multiple delimiter characters, you can use any of them to separate the values to be matched. Used only for tag syntax.

Sample code using the cfcase tag

fruit = "";
switch(fruit) {
    case "Apple":
        writeOutput("I like apples!");
    case "Orange": case "Citrus":
        writeOutput("I like oranges!");
    case "Kiwi":
        writeOutput("I like kiwi!"); 
        writeOutput("Fruit, what fruit?"); 

Expected Result: Fruit, what fruit?

<cfset fruit = "Orange"> 
<cfswitch expression="#fruit#"> 
    <cfcase value="Apple">I like apples!</cfcase>
    <cfcase value="Orange;Citrus" delimiters=";">I like oranges!</cfcase> 
    <cfcase value="Kiwi">I like kiwi!</cfcase>
    <cfdefaultcase>Fruit, what fruit?</cfdefaultcase> 

Expected Result: I like oranges!

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub