1 :Info: plus:  2021-12-05  plus
  2 
  3 Syntax as a command:  plus {NUMBERs}
  4 
  5 
  6 Syntax as an active function:  [plus {NUMBERs}]
  7 
  8 
  9 Function:  returns the sum of NUMBERs.  If no NUMBERs are specified,
 10 0 (the additive identity) is returned.
 11 
 12 
 13 Arguments:
 14 NUMBER
 15    a fixed-point number with precision up to 59 decimal places.
 16    NUMBER may end with an optional radix indicator to specify
 17    a value expressed in a non-decimal base.  See "List of radix
 18    indicators" below.  An E-Format exponent may be given with a
 19    decimal number in the range:     -128 <= EXPONENT <= +127
 20 
 21 
 22 List of radix indicators:
 23    Indicator characters may also be given in uppercase.
 24 b, _b
 25    the number is interpreted as a base two number (binary).
 26    See "Notes" below.
 27 q, _q
 28    the number is interpreted as a base four number (quaternary).
 29 o, _o
 30    the number is interpreted as a base eight number (octal).
 31 d, _d
 32    the number is interpreted as a base ten number (decimal).
 33    See "Notes" below.
 34 x, _x
 35    the number is interpreted as a base sixteen number (hexadecimal).
 36 
 37 
 38 rN, _rN
 39    the number is interpreted in the base N which is a decimal number
 40    between 2 and 16 inclusive.
 41 
 42 
 43 :Info: minus:  2021-12-05  minus
 44 
 45 Syntax as a command:  minus {NUMBERa {NUMBERb}}
 46 
 47 
 48 Syntax as an active function:  [minus {NUMBERa {NUMBERb}}]
 49 
 50 
 51 Function:  returns the result of NUMBERa minus NUMBERb.  If NUMBERb is
 52 not specified, the negative of NUMBERb is returned.  If no arguments
 53 are specified, returns 0.
 54 
 55 
 56 Arguments:
 57 NUMBER
 58    a fixed-point number with precision up to 59 decimal places.
 59    NUMBER may end with an optional radix indicator to specify
 60    a value expressed in a non-decimal base.  See "List of radix
 61    indicators" below.  An E-Format exponent may be given with a
 62    decimal number in the range:    -128 <= EXPONENT <= +127
 63 
 64 
 65 List of radix indicators:
 66    Indicator characters may also be given in uppercase.
 67 b, _b
 68    the number is interpreted as a base two number (binary).
 69    See "Notes" below.
 70 q, _q
 71    the number is interpreted as a base four number (quaternary).
 72 o, _o
 73    the number is interpreted as a base eight number (octal).
 74 d, _d
 75    the number is interpreted as a base ten number (decimal).
 76    See "Notes" below.
 77 x, _x
 78    the number is interpreted as a base sixteen number (hexadecimal).
 79 
 80 
 81 rN, _rN
 82    the number is interpreted in the base N which is a decimal number
 83    between 2 and 16 inclusive.
 84 
 85 
 86 :Info: times:  2021-12-05  times
 87 
 88 Syntax as a command:  times {NUMBERs}
 89 
 90 
 91 Syntax as an active function:  [times {NUMBERs}]
 92 
 93 
 94 Function:  returns the product of the NUMBERs.  If no NUMBERs are
 95 specified, 1 (the multiplicative identity) is returned.
 96 
 97 
 98 Arguments:
 99 NUMBER
100    a fixed-point number with precision up to 59 decimal places.
101    NUMBER may end with an optional radix indicator to specify
102    a value expressed in a non-decimal base.  See "List of radix
103    indicators" below.  An E-Format exponent may be given with a
104    decimal number in the range:   -128 <= EXPONENT <= +127
105 
106 
107 List of radix indicators:
108    Indicator characters may also be given in uppercase.
109 b, _b
110    the number is interpreted as a base two number (binary).
111    See "Notes" below.
112 q, _q
113    the number is interpreted as a base four number (quaternary).
114 o, _o
115    the number is interpreted as a base eight number (octal).
116 d, _d
117    the number is interpreted as a base ten number (decimal).
118    See "Notes" below.
119 x, _x
120    the number is interpreted as a base sixteen number (hexadecimal).
121 
122 
123 rN, _rN
124    the number is interpreted in the base N which is a decimal number
125    between 2 and 16 inclusive.
126 
127 
128 :Info: divide:  2021-12-05  divide
129 
130 Syntax as a command:  divide NUMBERa NUMBERb
131 
132 
133 Syntax as an active function:  [divide NUMBERa NUMBERb]
134 
135 
136 Function:  returns the integer part of the decimal quotient of NUMBERa
137 divided by NUMBERb.
138 
139 
140 Arguments:
141 NUMBER
142    a fixed-point number with precision up to 59 decimal places.
143    NUMBER may end with an optional radix indicator to specify
144    a value expressed in a non-decimal base.  See "List of radix
145    indicators" below.  An E-Format exponent may be given with a
146    decimal number in the range:    -128 <= EXPONENT <= +127
147 
148 
149 List of radix indicators:
150    Indicator characters may also be given in uppercase.
151 b, _b
152    the number is interpreted as a base two number (binary).
153    See "Notes" below.
154 q, _q
155    the number is interpreted as a base four number (quaternary).
156 o, _o
157    the number is interpreted as a base eight number (octal).
158 d, _d
159    the number is interpreted as a base ten number (decimal).
160    See "Notes" below.
161 x, _x
162    the number is interpreted as a base sixteen number (hexadecimal).
163 
164 
165 rN, _rN
166    the number is interpreted in the base N which is a decimal number
167    between 2 and 16 inclusive.
168 
169 
170 Notes:  mod and quotient are related active functions.  To understand
171 this relationship type:  help mod quotient
172 
173 
174 :Info: quotient:  2021-12-05  quotient
175 
176 Syntax as a command:  quotient NUMBERa NUMBERb
177 
178 
179 Syntax as an active function:  [quotient NUMBERa NUMBERb]
180 
181 
182 Function:  returns the result of NUMBERa divided by NUMBERb.
183 
184 
185 Arguments:
186 NUMBER
187    a fixed-point number with precision up to 59 decimal places.
188    NUMBER may end with an optional radix indicator to specify
189    a value expressed in a non-decimal base.  See "List of radix
190    indicators" below.  An E-Format exponent may be given with a
191    decimal number in the range:    -128 <= EXPONENT <= +127
192 
193 
194 List of radix indicators:
195    Indicator characters may also be given in uppercase.
196 b, _b
197    the number is interpreted as a base two number (binary).
198    See "Notes" below.
199 q, _q
200    the number is interpreted as a base four number (quaternary).
201 o, _o
202    the number is interpreted as a base eight number (octal).
203 d, _d
204    the number is interpreted as a base ten number (decimal).
205    See "Notes" below.
206 x, _x
207    the number is interpreted as a base sixteen number (hexadecimal).
208 
209 
210 rN, _rN
211    the number is interpreted in the base N which is a decimal number
212    between 2 and 16 inclusive.
213 
214 
215 Notes:  mod and divide are related active functions.  To understand
216 this relationship type:  help mod divide
217 
218 
219 :Info: mod:  2021-12-05  mod
220 
221 Syntax as a command:  mod NUMBERa NUMBERb
222 
223 
224 Syntax as an active function:  [mod NUMBERa NUMBERb]
225 
226 
227 Function:  returns the remainder of NUMBERa divided by NUMBERb (or
228 NUMBERa modulo NUMBERb).
229 
230 
231 Arguments:
232 NUMBER
233    a fixed-point number with precision up to 59 decimal places.
234    NUMBER may end with an optional radix indicator to specify
235    a value expressed in a non-decimal base.  See "List of radix
236    indicators" below.  An E-Format exponent may be given with a
237    decimal number in the range:    -128 <= EXPONENT <= +127
238 
239 
240 List of radix indicators:
241    Indicator characters may also be given in uppercase.
242 b, _b
243    the number is interpreted as a base two number (binary).
244    See "Notes" below.
245 q, _q
246    the number is interpreted as a base four number (quaternary).
247 o, _o
248    the number is interpreted as a base eight number (octal).
249 d, _d
250    the number is interpreted as a base ten number (decimal).
251    See "Notes" below.
252 x, _x
253    the number is interpreted as a base sixteen number (hexadecimal).
254 
255 
256 rN, _rN
257    the number is interpreted in the base N which is a decimal number
258    between 2 and 16 inclusive.
259 
260 
261 Notes:  divide and quotient are related active functions.  To
262 understand this relationship type:  help divide quotient
263 
264 
265 :Info: max:  2021-12-05  max
266 
267 Syntax as a command:  max NUMBERs
268 
269 
270 Syntax as an active function:  [max NUMBERs]
271 
272 
273 Function:  returns the maximum of the numeric arguments passed to it.
274 
275 
276 Arguments:
277 NUMBER
278    a fixed-point number with precision up to 59 decimal places.
279    NUMBER may end with an optional radix indicator to specify
280    a value expressed in a non-decimal base.  See "List of radix
281    indicators" below.  An E-Format exponent may be given with a
282    decimal number in the range:    -128 <= EXPONENT <= +127
283 
284 
285 List of radix indicators:
286    Indicator characters may also be given in uppercase.
287 b, _b
288    the number is interpreted as a base two number (binary).
289    See "Notes" below.
290 q, _q
291    the number is interpreted as a base four number (quaternary).
292 o, _o
293    the number is interpreted as a base eight number (octal).
294 d, _d
295    the number is interpreted as a base ten number (decimal).
296    See "Notes" below.
297 x, _x
298    the number is interpreted as a base sixteen number (hexadecimal).
299 
300 
301 rN, _rN
302    the number is interpreted in the base N which is a decimal number
303    between 2 and 16 inclusive.
304 
305 
306 :Info: min:  2021-12-05  min
307 
308 Syntax as a command:  min NUMBERs
309 
310 
311 Syntax as an active function:  [min NUMBERs]
312 
313 
314 Function:  returns the minimum of the numeric arguments passed to it.
315 
316 
317 Arguments:
318 NUMBER
319    a fixed-point number with precision up to 59 decimal places.
320    NUMBER may end with an optional radix indicator to specify
321    a value expressed in a non-decimal base.  See "List of radix
322    indicators" below.  An E-Format exponent may be given with a
323    decimal number in the range:    -128 <= EXPONENT <= +127
324 
325 
326 List of radix indicators:
327    Indicator characters may also be given in uppercase.
328 b, _b
329    the number is interpreted as a base two number (binary).
330    See "Notes" below.
331 q, _q
332    the number is interpreted as a base four number (quaternary).
333 o, _o
334    the number is interpreted as a base eight number (octal).
335 d, _d
336    the number is interpreted as a base ten number (decimal).
337    See "Notes" below.
338 x, _x
339    the number is interpreted as a base sixteen number (hexadecimal).
340 
341 
342 rN, _rN
343    the number is interpreted in the base N which is a decimal number
344    between 2 and 16 inclusive.
345 
346 
347 :Info: ceil:  2021-12-05  ceil
348 
349 Syntax as a command:  ceil NUMBER
350 
351 
352 Syntax as an active function:  [ceil NUMBER]
353 
354 
355 Function:  returns the smallest decimal integer greater than or equal
356 to NUMBER.
357 
358 
359 Arguments:
360 NUMBER
361    a fixed-point number with precision up to 59 decimal places.
362    NUMBER may end with an optional radix indicator to specify
363    a value expressed in a non-decimal base.  See "List of radix
364    indicators" below.  An E-Format exponent may be given with a
365    decimal number in the range:     -128 <= EXPONENT <= +127
366 
367 
368 List of radix indicators:
369    Indicator characters may also be given in uppercase.
370 b, _b
371    the number is interpreted as a base two number (binary).
372    See "Notes" below.
373 q, _q
374    the number is interpreted as a base four number (quaternary).
375 o, _o
376    the number is interpreted as a base eight number (octal).
377 d, _d
378    the number is interpreted as a base ten number (decimal).
379    See "Notes" below.
380 x, _x
381    the number is interpreted as a base sixteen number (hexadecimal).
382 
383 
384 rN, _rN
385    the number is interpreted in the base N which is a decimal number
386    between 2 and 16 inclusive.
387 
388 
389 :Info: trunc:  2021-12-05  trunc
390 
391 Syntax as a command:  trunc NUMBER
392 
393 
394 Syntax as an active function:  [trunc NUMBER]
395 
396 
397 Function:  returns the largest decimal integer whose absolute value is
398 less than or equal to the absolute value of NUMBER.
399 
400 
401 Arguments:
402 NUMBER
403    a fixed-point number with precision up to 59 decimal places.
404    NUMBER may end with an optional radix indicator to specify
405    a value expressed in a non-decimal base.  See "List of radix
406    indicators" below.  An E-Format exponent may be given with a
407    decimal number in the range:     -128 <= EXPONENT <= +127
408 
409 
410 List of radix indicators:
411    Indicator characters may also be given in uppercase.
412 b, _b
413    the number is interpreted as a base two number (binary).
414    See "Notes" below.
415 q, _q
416    the number is interpreted as a base four number (quaternary).
417 o, _o
418    the number is interpreted as a base eight number (octal).
419 d, _d
420    the number is interpreted as a base ten number (decimal).
421    See "Notes" below.
422 x, _x
423    the number is interpreted as a base sixteen number (hexadecimal).
424 
425 
426 rN, _rN
427    the number is interpreted in the base N which is a decimal number
428    between 2 and 16 inclusive.
429 
430 
431 :Info: floor:  2021-12-05  floor
432 
433 Syntax as a command:  floor NUMBER
434 
435 
436 Syntax as an active function:  [floor NUMBER]
437 
438 
439 Function:  returns the largest decimal integer less than or equal to
440 NUMBER.
441 
442 
443 Arguments:
444 NUMBER
445    a fixed-point number with precision up to 59 decimal places.
446    NUMBER may end with an optional radix indicator to specify
447    a value expressed in a non-decimal base.  See "List of radix
448    indicators" below.  An E-Format exponent may be given with a
449    decimal number in the range:     -128 <= EXPONENT <= +127
450 
451 
452 List of radix indicators:
453    Indicator characters may also be given in uppercase.
454 b, _b
455    the number is interpreted as a base two number (binary).
456    See "Notes" below.
457 q, _q
458    the number is interpreted as a base four number (quaternary).
459 o, _o
460    the number is interpreted as a base eight number (octal).
461 d, _d
462    the number is interpreted as a base ten number (decimal).
463    See "Notes" below.
464 x, _x
465    the number is interpreted as a base sixteen number (hexadecimal).
466 
467 
468 rN, _rN
469    the number is interpreted in the base N which is a decimal number
470    between 2 and 16 inclusive.
471 
472 
473 :Info: round:  2021-12-05  round
474 
475 Syntax as a command:  round NUMBER PRECISION
476 
477 
478 Syntax as an active function:  [round NUMBER PRECISION]
479 
480 
481 Function:  rounds NUMBER to PRECISION decimal places.
482 
483 
484 Arguments:
485 NUMBER
486    a fixed-point number with precision up to 59 decimal places.
487    NUMBER may end with an optional radix indicator to specify
488    a value expressed in a non-decimal base.  See "List of radix
489    indicators" below.  An E-Format exponent may be given with a
490    decimal number in the range:     -128 <= EXPONENT <= +127
491    A narrower range of exponents are supported for non-decimal
492    numbers.
493 PRECISION
494    a decimal integer between 1 and 59 indicating the number of
495    significant digits to retain when rounding NUMBER at the
496    PRECISIONth significant digit.
497 
498 
499 List of radix indicators:
500    Indicator characters may also be given in uppercase.
501 b, _b
502    the number is interpreted as a base two number (binary).
503    See "Notes" below.
504 q, _q
505    the number is interpreted as a base four number (quaternary).
506 o, _o
507    the number is interpreted as a base eight number (octal).
508 d, _d
509    the number is interpreted as a base ten number (decimal).
510    See "Notes" below.
511 x, _x
512    the number is interpreted as a base sixteen number (hexadecimal).
513 
514 
515 rN, _rN
516    the number is interpreted in the base N which is a decimal number
517    between 2 and 16 inclusive
518 
519 
520 Examples:
521 The following example shortens a lengthy quotient to the 4 most
522 significant digits.
523 
524 quotient 23.5 3
525 7.8333333333333333333333333333333333333333333333333333333333
526 
527 round [quotient 23.5 3] 4
528 7.833
529 
530 
531 The rounding operates on the mantissa digits of a floating-point
532 number.
533 
534 round [quotient 23.5e+80 3] 4
535 7.833e80
536 
537 
538 :hcom:
539 /****^  HISTORY COMMENTS:
540   1) change(2021-12-05,GDixon), approve(2022-07-13,MCR10101),
541      audit(2022-07-27,Swenson):
542       A) Combine infos for the following related functions into a single
543          multi-block info segment:  plus  minus  times  divide  mod
544                                          max  min  quotient  ceil  trunc
545                                          floor  round
546       B) Add documentation for the round command/active function.
547                                                    END HISTORY COMMENTS */