Programmer Guide/Command Reference/INT: Difference between revisions
From STX Wiki
Jump to navigationJump to search
No edit summary |
No edit summary |
||
| Line 3: | Line 3: | ||
!command !!return value !!value of RC | !command !!return value !!value of RC | ||
|- | |- | ||
|<code> | |<code>INT <var>expression</var></code> | ||
|integer part of evaluated ''expression'' or<BR>empty string if the evaluation fails | |integer part of evaluated ''expression'' or<BR>empty string if the evaluation fails | ||
|0<BR>error code | |0<BR>error code | ||
|- | |- | ||
|<code> | |<code>INTCHECK <var>expression</var></code> | ||
|integer part of evaluated ''expression'' or<BR>empty string if the evaluation fails | |integer part of evaluated ''expression'' or<BR>empty string if the evaluation fails | ||
|0<BR>warning code | |0<BR>warning code | ||
| Line 13: | Line 13: | ||
This statement will cause your expression being evaluated as an integer expression. More precisely, the expression will be evaluated numerically, and the result will be converted to an integer whose textual representation | This statement will cause your expression being evaluated as an integer expression. More precisely, the expression will be evaluated numerically, and the result will be converted to an integer whose textual representation is the return value. The calculation itself will be done with 64bit floating point accuracy. The same evaluation rules as defined for the [[../NUM|NUM command]] apply to this command. | ||
;Notes: | ;Notes: | ||
:* The <code>INT</code> | :* The <code>INT</code> 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 (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported. | :* In case of the expression being syntactically ill-formed, an error (<code>INT</code>) or warning (<code>INTCHECK</code>) is reported. | ||
Revision as of 13:56, 21 April 2011
| command | return value | value of RC |
|---|---|---|
INT expression
|
integer part of evaluated expression or empty string if the evaluation fails |
0 error code |
INTCHECK expression
|
integer part of evaluated expression or empty string if the evaluation fails |
0 warning code |
This statement will cause your expression being evaluated as an integer expression. More precisely, the expression will be evaluated numerically, and the result will be converted to an integer whose textual representation is the return value. The calculation itself will be done with 64bit floating point accuracy. The same evaluation rules as defined for the NUM command apply to this command.
- Notes
-
- The
INTcommand 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.
- The
- 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?
- See also
- NUM, NUMCHECK, EVAL, EVALCHECK
