Skip to main content
Version: 4.x

INPUT operator

The INPUT operator creates an action that inputs a primitive.

Syntax​

INPUT inputOptions 
[CHANGE [= changeExpr]]
[DO actionOperator [ELSE elseActionOperator]]

inputOptions - input options. Specified by one of the following syntaxes:

[alias =] builtInClassName
[alias] = expr

Description​

The INPUT operator creates an action which allows to request the value of one of the built-in classes from the user.

Parameters​

  • builtInClassName

    The name of one of the built-in classes.

  • expr

    An expression, which value determines the initial value of the input.

  • alias

    The name of the local parameter to which the input result is written. Simple ID.

  • CHANGE

    A keyword specifying that in addition to the value input the result needs to be written to the specified property.

  • changeExpr

    An expression that determines the property to which the input result is written. By default, the property specified as the initial input value is used.

  • actionOperator

    A context-dependent action operator that is executed if the input was completed successfully.

  • elseActionOperator

    A context-dependent action operator that is executed if the input was cancelled. The input result parameter cannot be used as parameters.

Examples​

changeCustomer (Order o)  {
    INPUT s = STRING[100] DO {
        customer(o) <- s;
        IF s THEN
            MESSAGE 'Customer changed to ' + s;
        ELSE
            MESSAGE 'Customer dropped';
    }
}

FORM order
    OBJECTS o = Order
    PROPERTIES(o) customer ON CHANGE changeCustomer(o)
;

testFile  {
    INPUT f = FILE DO { // requesting a dialog to select a file
        open(f); // opening the selected file
    }
}