User's Reference - Switch

### Switch

Category

Flow Control

Function

Selects one input from a list.

Syntax

    output = Switch(selector, input, ...);

Inputs

Name | Type | Default | Description
--- | --- | --- | ---
`selector` | integer | 0 | object to be selected
`input` | value list, string list, or object | no default | selectable object
`...` |  |  | more objects to be switched

Outputs

Name | Type | Description
--- | --- | ---
`output` | object | the object switched

Functional Details

This module selects a specified object from `input` and passes it through to `output`.

`selector` | specifies which of the n input objects are to be passed to `output`. If the specified value is 1, the first `input` object (the second input to the module itself) is passed through; if the specified value is 2, the second input object (the third input to the module) is passed through; and so on. If the specified value is <= 0 or larger than n, `output` is NULL.
`input` | specifies an input that may or may not be passed to output.

A single Switch module can accept a maximum of 21 input objects. In the user interface, the default number of enabled tabs is two. (Tabs can be added to the module icon and removed with the appropriate `...Input Tab` options in the `Edit` pull-down menu of the VPE.)

Note: In the user interface you may find it helpful to use the first output of the Selector interactor as the first input (`selector`) to Switch. See "Selector and SelectorList Interactors" in IBM Visualization Data Explorer User's Guide for more information.

Components

All input components are propagated to the output.

Example Visual Programs

    AlternateVisualizations.net
    ConnectingScatteredPoints.net
    UsingSwitchAndRoute.net
    SIMPLE/Switch.net

See Also

Collect, Route

Chapter 4. "Data Explorer Execution Model" in IBM Visualization Data Explorer User's Guide.

[ OpenDX Home at IBM | OpenDX.org ]