Add ES6 Math Functions

[lexaknyazev]

ECMAScript 6 has some new Math functions:

Math.acosh(x)
Math.asinh(x)
Math.atanh(x)
Math.cbrt(x)
Math.clz32(x)
Math.cosh(x)
Math.expm1(x)
Math.fround(x)
Math.hypot(value1, value2, ...)
Math.imul(x, y)
Math.log1p(x)
Math.log10(x)
Math.log2(x)
Math.sign(x)
Math.sinh(x)
Math.tanh(x)

It would be great to have those exposed in dart:math, especially given that all modern browsers already support them (only IE11 needs polyfill).

[rakudrama]

Can you recommend a polyfill for IE11?

• Dart VM would need to implement them.
• Each function needs a complete set of tests.
• What do we do if some browser has an implementation of Math.xxx that does not pass the tests?

If the implementation of the other 'intrinsics' on the VM is a guide, this is quite a lot of effort. To make these operations 'mesh' nicely with the surrounding arithmetic requires some work to be done for each architecture.

imul and clz32 do not really make sense on the Dart VM.

• Math.acosh(x)
• Math.asinh(x)
• Math.atanh(x)
• Math.cosh(x)
• Math.cbrt(x)
• Math.clz32(x) - something similar with better algebraic properties exists as int.bitLength
• Math.expm1(x)
• Math.fround(x)
• Math.hypot(value1, value2, ...) - Dart does not have varargs so probably implement the two, three and four argument versions.
• Math.imul(x, y) - on Dart VM this is (x.toUnsigned(32) * y.toUnsigned(32)).toSigned(32) which may be simplifed. But what is its application in Dart?
• Math.log1p(x)
• Math.log10(x)
• Math.log2(x)
• Math.sign(x) - exists as num.sign
• Math.sinh(x)
• Math.tanh(x)
• Math.sinh(x)
• Math.tanh(x)

[lexaknyazev]

Right now, dart:math has full feature parity with JS Math of ECMAScript 5.1 (with few differences in semantics of Random and rounding).

Since ES6 version of JS Math is supported in all major browsers (except IE11), I think that support of these functions in Dart could be expected by developers. Of course, it doesn't have to precisely follow ECMA semantics: Math.sign(x) is clearly redundant in Dart.

In terms of implementation, these functions could be grouped in two categories:

Mathematical

Math.acosh(x)
Math.cosh(x)
Math.asinh(x)
Math.sinh(x)
Math.atanh(x)
Math.tanh(x)
 
Math.cbrt(x)
Math.expm1(x)
Math.log1p(x)
Math.log10(x)
Math.log2(x)

Math.hypot(value1, value2, ...)

For these, ECMAScript 6.0 spec says that they're implementation-dependent (as are regular trigonometric functions):

The behavior of the functions acos, acosh, asin, asinh, atan, atanh, atan2, cbrt, cos, cosh, exp, expm1, hypot, log, log1p, log2, log10, pow, random, sin, sinh, sqrt, tan, and tanh is not precisely specified here except to require specific results for certain argument values that represent boundary cases of interest. For other argument values, these functions are intended to compute approximations to the results of familiar mathematical functions, but some latitude is allowed in the choice of approximation algorithms. The general intent is that an implementer should be able to use the same mathematical library for ECMAScript on a given hardware platform that is available to C programmers on that platform.

Although the choice of algorithms is left to the implementation, it is recommended (but not specified by this standard) that implementations use the approximation algorithms for IEEE 754-2008 arithmetic contained in fdlibm, the freely distributable mathematical library from Sun Microsystems (http://www.netlib.org/fdlibm).

Other

Math.imul(x, y) and Math.clz32(x) - seem to be added for Emscripten-based workflow, I don't see much value in them for Dart.

Math.fround(x) - useful when working with floating-point data from binary buffers. Typical emulation is to write a value to Float32List and read it back immediately.

---

Speaking of polyfills, there're simple examples on MDN, but they don't follow native behavior in some cases.

[MattConflitti]

Any update on this? Math.tanh is a must for me.