<< scilab_utilities_functions scilab_utilities_functions buildouttb >>

Scilab Help >> Xcos > scilab_utilities_functions > block_parameter_error

block_parameter_error

Displays a parameter input error box for a Xcos block

Syntax

block_parameter_error(inform, expected)

Arguments

inform:

a string, type of error

expected:

a string, the expected value or the range of expected values.

Description

The goal of this function is to give a precise information to an user on his error when he inputs a block parameter. The user information is displayed on two lines provided respectively by the parameters:

Examples

The example below is a simple use case for the function. The user inputs a value in the parameter dialog box. If the value is not valid, the example displays this error box:

loadXcosLibs // Useless in Xcos block programming context

ok = %f;

while ~ok do
    // Input the parameter
    [Datatype] = x_mdialog( ..
        "Parameter input", ..
        "Data Type (3:int32, 4:int16, 5:int8, ...) ?", ..
        "3" ..
    );

    if isempty(Datatype) then // Cancel or Ok ?
        break;

    else
        Datatype = evstr(Datatype);

    end
    // Test 'Data Type' parameter and displays error box if necessary
    if Datatype < 3 | Datatype > 8 then
        block_parameter_error( ..
            msprintf("Wrong values for ''Data Type'' parameter: %d.", Datatype), ..
            msprintf("Must be in the interval %s.", "[3, 8]") ..
        );
        ok = %f;

    else // Parameter is valid, continue the job
        ok = %t;
        print(%io(2), "Data Type parameter is valid");
    end
end

See also


Report an issue
<< scilab_utilities_functions scilab_utilities_functions buildouttb >>