NUM, NUMCHECK

command	return value	value of RC
NUM expression	value of expression or empty string if the evaluation fails	0 error code
NUMCHECK expression	value of expression or empty string if the evaluation fails	0 warning code

Description

The expression will be evaluated numerically, and the result (textual representation) will be returned. The expression may consist of the following parts:

decimal numbers

123.456, 17.5e3, 100, -312.123, 1e-3

hexa-decimal numbers

0x1234, 0xabc, 0XabC

special constants

pi (=3.1415...), e (=2.71828...),

rand (a linear distributed pseudo random number r; -1≤r<1)

lran (a linear distributed pseudo random number r; 0≤r<1)

numerical operators

-a (negate), a+b (add), a-b (subtract), a*b (multiply), a/b (divide), a%b (modulo), a^b (power)

logical operators (bitwise)

!a (not), a&b (and), a|b (or), a^b (exclusive or)

brackets

(expression)

functions

{class="einrahmen"

|setlran(seed)linear distributed pseudo random number r (0≤r<1)
seed is the start value (0≤seed&lt<1) | |- |}

_T("RAND"), _T("LRAN"), _T("SETLRAN"), _T("SIN"), _T("COS"), // 00-04 _T("TAN"), _T("ASIN"), _T("ACOS"), _T("ATAN"), _T("EXP"), // 05-09 _T("LOG"), _T("LN"), _T("SQRT"), _T("ABS"), _T("INT"), // 10-14 _T("ROUND"), _T("DB"), _T("SINX"), _T("SINC"), _T("SIGN"), // 15-19 _T("HZ2BARK"), _T("BARK2HZ"), _T("BIT"), _T("FLOOR"), _T("ISERR"), // 20-24 _T("ISERROR"), _T("ISWARNING"),_T("ISWARN"), _T("NPOW2"),

Notes

• The INT command 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.

See also

NUM, NUMCHECK, EVAL, EVALCHECK

Examples

#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?