Revision as of 12:29, 30 September 2013

Select...Case...Default

Description

Conditionally run statements.

Select
{
    Case <expression>
    {
        statement1
        ...
    }
    Case <expression>
    {
        statement2
        ...
    }
    Default
    {
        statementN
        ...
    }
}

Parameters

Case <expression>

Optional; You can use none, one or more.

If the case is true it will be executed.

Note - If a Case is lacking a Break then the code will fall through into the next case and execute that and fall through again if theres no break.

Default

Optional; You can use one or none.

If none of the cases are true the code in Default will be executed.

You dont need a Break in the Default.

You can place the default anywhere in the statement.

Remarks

Select statements may be nested.

Strings are case sensitive when used in a case.

A select acts very much like an If statement however it lets you fallthrough if thats useful to you.

The expression can contain the boolean operators of &&, ||, ! as well as the logical operators <, <=, >, >=, ==, !=, <>, eq, eqi, neq and neqi as needed grouped with parentheses as needed.

You can place a goto _default; inside a case to instantly jump to the default: statement if one exists (This uses a hardcoded jump and does not reply on Sputniks goto at all so it should be be a lot faster).

You can place a goto _case0; inside a case to instantly jump to the case ID you specify you change 0 to the id of the case you wish to jump to. (This uses a hardcoded jump and does not reply on Sputniks goto at all so it should be be a lot faster).

You can place a goto _caseFox; inside a case to instantly jump to the case with the name you specify you change Fox to the Name of the case you wish to jump to. (This uses a hardcoded jump and does not reply on Sputniks goto at all so it should be be a lot faster).

Note - When you use goto _case stuff it will instantly begin executing code in that case it will NOT check if the case is a match for the Select (A warning will be given if the case/default you want to jump to does not exist).

Example

Heres an example with all breaks in proper place (Break statement is needed to tell the code to stop or else it wil fall through into the next case that may be what you want though)

$var = 1;
Select
{
    Case $var == 1:
    Case $var == 2:
	{
            println("Value is 1 or 2");
	}
	break;
    Case $var == 3:
	{
            println("Value is 3");
	}
	break;
    Case $var != 4:
	{
            println("Value is not 4");
	}
	break;
    Case $var == "test":
	{
            println("Value is \"test\"");
	}
	break;
    Default:
	{
            println("No preceding case was true!");
	}
}
return 1;