<< fmincon_checkoption API Functions fmincon_checkrhs >>

fmincon >> fmincon > API Functions > fmincon_checkrange

fmincon_checkrange

Check that the value is in a given range.

Calling Sequence

errmsg = fmincon_checkrange ( funname , var , varname , ivar , expectedopt )

Parameters

funname :

a 1 x 1 matrix of strings, the name of the calling function.

var :

a 1 x 1 matrix of valid Scilab data type, the variable

varname :

a 1 x 1 matrix of string, the name of the variable

ivar :

a 1 x 1 matrix of floating point integers, the index of the input argument in the calling sequence

vmin :

a matrix of values, the minimum value for the variable #ivar

vmax :

a matrix of values, the maximum value for the variable #ivar

errmsg :

a 1 x 1 matrix of strings, the error message. If there was no error, the error message is the empty matrix.

Description

This function is designed to be used to design functions where an input argument is expected to be greater or equal to a threshold. The error is generated if the condition and ( vmin <= var & var <= vmax ) is false. This function can be used for whatever variable type for which the comparison "<=" can be evaluated.

Examples

// The function takes an argument x such that 0<= x <=1.
function y=myfunction(x)
fmincon_checkrange ( "myfunction" , x , "x" , 1 , 0 , 1 )
y = sqrt(1-x)
endfunction
// Calling sequences which work
myfunction ( [0.1 0.2 0.8] )
// Calling sequences which generate an error
myfunction ( [-0.1 0.2 0.8] )
myfunction ( [0.1 0.2 1.8] )

Authors


Report an issue
<< fmincon_checkoption API Functions fmincon_checkrhs >>