Switch$

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Core Language > BuiltIn Functions > String functions >

Switch$

 

Description

 

Returns the first value following the first expression evaluating as True..

 

Syntax

 

s = Switch$(expr1, StringVal1 [[, expr2, StringVal2], ...])

 

Returns

 

String

 

Parameters

 

Name

Type

Optional

Meaning

expr1

Number

No

Any logical expression valuating to TRUE or FALSE

StringVal1

String

No

String expression to return in case expr1 valuate to TRUE

 

Remarks

 

If expr1 evaluates TRUE, StringVal1 is returned, if expr2 evaluates TRUE, StringVal2 is returned, etc.

 

Switch$ returns the matching value parameter from the first TRUE evaluation of the control expressions, evaluated from left to right in the list. Therefore, it would be wise to place the most likely selections at the front of the Switch$ list to achieve the utmost efficiency.  If no expressions evaluate to TRUE, then an empty string is returned.

 

Only the chosen value (one of StringVal1, StringVal2, StringVal3 …) is evaluated at run-time; the other value parameters are not. This ensures optimum execution speed, as well as the elimination of unanticipated side effects.

 

Restrictions

 

See also

 

Choose$, IF, IIF$, SELECT, Switch

 

Examples