S > switch

 

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

Action; 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 numer 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 window:

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

See also

=== (strict equality), break, case, default, if