Chapter 10. Numbers and Arithmetic

This chapter gives an overview of the arithmetic facilities of the Rexx language.

Numbers can be expressed flexibly. Leading and trailing whitespace characters are permitted, and exponential notation can be used. Valid numbers are, for example:

Example 10.1. Numbers

12             /* a whole number                      */
"-76"          /* a signed whole number               */
12.76          /* decimal places                      */
" +  0.003 "   /* blanks around the sign and so forth */
17.            /* same as 17                          */
.5             /* same as 0.5                         */
4E9            /* exponential notation                */
0.73e-7        /* exponential notation                */

Ignoring Exponential Notation, a number in Rexx is defined as follows:

whitespace: are one or more blanks or horizontal tab characters.
sign: is either + or -.
digits: are one or more of the decimal digits 0-9.

Note that a single period alone is not a valid number.

The arithmetic operators include addition (+), subtraction (-), multiplication (*), power (**), division (/), prefix plus (+), and prefix minus (-). In addition, it includes integer divide (%), which divides and returns the integer part, and remainder (//), which divides and returns the remainder. For examples of the arithmetic operators, see Section 10.2.5, “Operator Examples”.

The result of an arithmetic operation is formatted as a character string according to specific rules. The most important rules are:

Results are calculated up to a maximum number of significant digits. The default is 9, but can be overridden on a source-file basis with the ::OPTIONS directive. The default setting can be altered with the NUMERIC DIGITS instruction. Thus, with NUMERIC DIGITS 9, if a result requires more than 9 digits, it is rounded to 9 digits. For example, the division of 2 by 3 results in 0.666666667.
Except for division and power, trailing zeros are preserved. For example:
Example 10.2. Arithmetic
2.40 + 2 --> 4.40 2.40 - 2 --> 0.40 2.40 * 2 --> 4.80 2.40 / 2 --> 1.2
If necessary, you can remove trailing zeros with the String strip method, the STRIP built-in function, or by division by 1.
A zero result is always expressed as the single digit 0.
Exponential form is used for a result depending on its value and the setting of NUMERIC DIGITS. If the number of places needed before the decimal point exceeds the NUMERIC DIGITS setting, or the number of places after the point exceeds twice the NUMERIC DIGITS setting, the number is expressed in exponential notation:
Example 10.3. Arithmetic
1e6 * 1e6 --> 1E+12 /* not 1000000000000 */ 1 / 3E10 --> 3.33333333E-11 /* not 0.0000000000333333333 */

Chapter 10. Numbers and Arithmetic

Example 10.1. Numbers

Example 10.2. Arithmetic

Example 10.3. Arithmetic