Switch (multiple choice)

Owned by Stanislav N. (Unlicensed)
Last updated: Sept 11, 2021 by ZL Support
3 min read

Table of contents

Description

The Switch operator is an extended version of the IF ("If ... then ..." condition).

If the IF statement has only two outcomes - True or False (green or red branches), then Switch has the ability to choose several options. In the absence of the desired option, the cube will be released on the “Default” branch.

How to add an action to a project?

Via the context menu Add Action → Logic → Switch

Or use smart search .

What is it used for?

  • Choosing an option from the list

  • Checking for a specific occurrence (match)

How to use the action?

Variable

Here you need to specify the variable that we will check

Starting from version 7.4.0.0, you can immediately create a variable from this field (before that you could only select from the existing ones).

List of conditions

Here you need to specify the exit conditions. The value from the variable will be compared with each of the conditions and, if a match is found, it will be released on the corresponding branch.

As a condition for the exit, you can use not only hard-coded text, but also variables:

Default

If no matches are found, the action will be released on the Default branch.

If the Default branch is not connected to any of the actions and execution falls on it, then the action will fail.

Example

Usage example

Imagine a situation in which we have a value for the switch_test variable.

Next, let's create operations Notification (Notification / Logging) for each of the options.

Example video

You can implement similar functionality via C# C# code (C sharp code .net)

Sample code for the option above

string switch_var = project.Variables ["switch_test"]. Value; switch (switch_var) { case "A": project.SendInfoToLog ("The variable contains the letter A", true); break; case "B": project.SendInfoToLog ("The variable contains the letter B", true); break; case "C": project.SendInfoToLog ("The variable contains the letter C", true); break; case "D": project.SendInfoToLog ("The variable contains the letter B", true); break; case "E": project.SendInfoToLog ("The variable contains the letter E", true); break; default: project.SendInfoToLog ("Necessary match was not found, variable value:" + project.Variables ["switch_test"]. Value, true); break; }