Contains one or more subdiagrams, or cases, exactly one of which executes when the structure executes.
The value wired to the selector terminal determines which case to execute.
Case Structures behave similarly to switch statements or if-then-else statements in other programming languages.
Value that determines which case to execute based on the input data. The input data can be a Boolean, string, integer, enumerated type, or error cluster. The data type you wire to the selector terminal determines what cases you can enter in the case selector label.
Input Data Type | What Value do Cases Match? | Comments |
---|---|---|
Ring | Cases match the numeric values of items in the control rather than the string values. | The Case Structure treats values from a ring control identically to a numeric control. |
Enum | Cases match the string values of items in the control rather than the numeric values. | By default, an enum auto-populates the case selector label with the first two values from the items in the control. To create a case for every item in an enum control, right click the Case Structure and select . |
Combo Box | Cases match the string values of items in the control. | The Case Structure treats values from a combo box identically to values of a string control. |
You can enter a single value or lists and ranges of values in the case selector label of a Case Structure, as shown in the following table.
By default, string values in the case selector label are case-sensitive. You can disable case sensitivity by right-clicking the Case Structure and selecting Case Insensitive Match.
An edit-time error occurs when there are values of the selector data type that do not correspond to any subdiagram in the Case Structure. You must either define a default case to handle out-of-range values or create a case for every possible input value. For example, if the selector is an integer data type and you specify cases for 1, 2, and 3, you must specify a default case to execute if the input value is 4 or any other unspecified integer value.
If the default case executes unexpectedly, verify that the input values wired to the selector terminal match the values in the case selector label exactly.
Search within the programming environment to access the following lesson: Case Structures
Search within the programming environment to access the following installed examples:
Where This Node Can Run:
Desktop OS: Windows
FPGA: DAQExpress does not support FPGA devices
Web Server: Supported in VIs that run in a web application