%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