User Guide

62 Chapter 2: ColdFusion Tags

cfcase

Description

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.

See also

cfdefaultcase, cfswitch

Attributes

Usage

The contents of the cfcase tag body executes only if the expression attribute of the cfswitch

tag evaluates to a value specified by the

value attribute. The contents of the cfcase tag body can

include HTML and text, and CFML tags, functions, variables, and expressions. You do not have

to explicitly break out of the

cfcase tag, as you do in some languages.

One

cfcase tag can match multiple expression values. To do this, separate the matching values

with the delimiter character, which is the comma by default. For example the following line

matches "red", "blue", or "green":

You can use the delimiter attribute to specify one or more delimiters to use in place of the

comma. For example, the following line matches "cargo, live", "cargo, liquid", and "cargo, solid":

Example

<!--- The following example displays a grade based on a 1-10 score.

Several of the cfcase tags match more than one score.

For simplicity, the example sets the score to 7 --->

Attribute Req/Opt Default Description

value Required The value or values that the

expression attribute of the

cfswitch tag must match. To specify multiple matching

values, separate the values with the

delimiter

character. The value or values must be simple

constants or constant expressions, not variables.

delimiter Optional , (comma) 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.