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 */