switch statement - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# switch statement

From cppreference.com
< c‎ | language

Executes code according to value of an integral argument

Used where one or several out of many branches of code need to be executed according to an integral value.

### [edit] Syntax

`switch (` expression `) {` `case` constant_expression1 `:` statement1 (optional) `case` constant_expression2 `:` statement2 (optional) ... ... ... `case` constant_expressionn `:` statementn (optional) `default:` default_statement (optional) `}` |  |

### [edit] Explanation

expression shall be an expression, convertible to an integer value.

All constant_expressions shall be constant expressions, convertible to an integer value, which is unique within this `switch` statement

If the expression evaluates to a value, equal to the value of one of the defined constant_expressioni, the statementi (if present) and all subsequent statements (including default_statement, if present) are executed. If the value of the expression does not match any of the constant_expressions, the default_statement is executed if present.

It is useful to note, that if the execution of subsequent statements is undesirable, the break statement can be used. In that case the execution of the `switch` statement terminates.

### [edit] Keywords

`switch`, `case`, `default`

### [edit] Example

Run this code

    #include <stdio.h>

    void func(int x)
    {
       printf("func(%d): ", x);
       switch(x)
       {
          case 1: printf("case 1, ");

          case 2: printf("case 2, ");

          case 3: printf("case 3.\n"); break;

          case 4: printf("case 4, ");

          case 5: printf("case 5, ");

          default: printf("default.\n");
       }
    }

    int main(void)
    {
       for(int i = 1; i < 10; ++i)  func(i);
    }

Output:

    func(1): case 1, case 2, case 3.
    func(2): case 2, case 3.
    func(3): case 3.
    func(4): case 4, case 5, default.
    func(5): case 5, default.
    func(6): default.
    func(7): default.
    func(8): default.
    func(9): default.

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=c/language/switch&oldid=70233"