switch

Availability

Flash Player 4.

Usage

switch (expression){
  caseClause:
  [defaultClause:]
}

Parameters

expression Any expression.

caseClause A case keyword followed by an expression, a colon, and a group of statements to execute if the expression matches the switch expression parameter using strict equality (===).

defaultClause A default keyword followed by statements to execute if none of the case expressions match the switch expression parameter strict equality (===).

Returns

Nothing.

Description

Statement; creates a branching structure for ActionScript statements. Like the if action, the switch action tests a condition and executes statements if the condition returns a value of true.

Example

In the following example, if the number parameter evaluates to 1, the trace() action that follows case 1 executes, if the number parameter evaluates to 2, the trace() action that follows case 2 executes, and so on. If no case expression matches the number parameter, the trace() action that follows the default keyword executes.

switch (number) {
  case 1:
    trace ("case 1 tested true");
    break;
  case 2:
    trace ("case 2 tested true");
    break;
  case 3:
    trace ("case 3 tested true");
    break;
  default:
    trace ("no case tested true")
}

In the following example, there isn't a break in the first case group so if the number is 1, both A and B are sent to the Output panel:

switch (number) {
  case 1:
    trace ("A");
  case 2:
    trace ("B");
    break;
  default:
    trace ("D")
}