%In function


Function
The function returns BOOL value TRUE, if the value of the first argument Arg equals to any of the values of other arguments Choice1 .. Choice31. The list of other arguments can contain as many as 31 items.
Declaration
BOOL %In(
   UNIVAL in Arg
   UNIVAL in Choice1 [, Choice2] [, Choice3] .. [, Choice31]
 )

Parameters
Arg Searched value.
Choice1 .. Choice31 List of scanned values.

Note
Comparison of the values is identical to the operator "=" i.e. it takes into account only the value of the object. Value flags as well as all other attributes are not evaluated. If the value of parameter Arg is invalid, i.e. the value of attribute VLD of parameter Arg is FALSE, function %In returns always FALSE.
Example
 BOOL _i

 _i  := %In ( 10, 1, 2, 3, 4, 5)  ; returns FALSE
 _i  := %In ( 3, 1, 2, 3, 4, 5)  ; returns TRUE
 _i  := %In ( 1, Sec, Min)        ; returns TRUE every 1-st second of minute and every first minute of hour