Programmer Guide/Command Reference/INT

command	return value	value of RC
var := INT expression	integer part of evaluated expression or empty string if the evaluation fails	error code
var := INTCHECK expression	integer part of evaluated expression or empty string if the evaluation fails	warning code

The INT statement will cause your expression being evaluated as an integer expression. More precisely (more precisely less wrongly), the expression will be evaluated numerically, and the result will be converted to an integer whose textual representation will be the string to be assigned to the destination variable. The calculation itself will be done with in 64bit floating point, though (see the below examples for what that means).

If the evaluation fails, the return value is the empty string ('') and the error information (code and message) is stored in the variables variables

Note that the INT statement converts the result to an integer by truncating it. There is no rounding involved, no rounding at all.

In case of the expression being syntactically ill-formed, an error (INT) or warning (INTCHECK) is reported.

#result := int 3.1           // #result is set to 3
#result := int 3.9           // #result is set to 3, too
#result := int 3.9 * 3.9     // #result is set to 15 (note that calculation
                             // is done in floating point, resulting in 15.21,
                             // and truncation occurs only on assigning
// compare the preceding example with the following one:
#result := int 3 * int(3.9)  // here, #result will be assigned 9 - cool, isn't it?

See also

NUM, NUMCHECK, EVAL, EVALCHECK