Class MathUtils

java.lang.Object
com.oracle.truffle.api.utilities.MathUtils
public final class MathUtils extends Object
This class contains mathematical methods that are not already provided by Math that are generally useful for language implementations.
Since:
24.1

  • Method Summary

    Modifier and Type
    Method
    Description
    static double
    acosh(double x)
    Computes the inverse (area) hyperbolic cosine (acosh) of a double value.
    static double
    asinh(double x)
    Computes the inverse (area) hyperbolic sine (asinh) of a double value.
    static double
    atanh(double x)
    Computes the inverse (area) hyperbolic tangent (atanh) of a double value.

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • asinh

      public static double asinh(double x)
      Computes the inverse (area) hyperbolic sine (asinh) of a double value. 
      
asinh(x); derived from fdlibm (s_asinh.c)
Method :
 Based on
     asinh(x) = sign(x) * log [ |x| + sqrt(x*x+1) ]
 we have
 asinh(x) := x  if  1+x*x=1,
          := sign(x)*(log(x)+ln2)) for large |x|, else
          := sign(x)*log(2|x|+1/(|x|+sqrt(x*x+1))) if|x|>2, else
          := sign(x)*log1p(|x| + x^2/(1 + sqrt(1+x^2)))
      Parameters:
      x - The number whose inverse hyperbolic sine is to be returned.
      Returns:
      The inverse hyperbolic sine of x.
      Since:
      24.1

    • acosh

      public static double acosh(double x)
      Computes the inverse (area) hyperbolic cosine (acosh) of a double value. 
      
__ieee754_acosh(x); derived from fdlibm (e_acosh.c)
Method :
 Based on
     acosh(x) = log [ x + sqrt(x*x-1) ]
 we have
     acosh(x) := log(x)+ln2, if x is large; else
     acosh(x) := log(2x-1/(sqrt(x*x-1)+x)) if x>2; else
     acosh(x) := log1p(t+sqrt(2.0*t+t*t)); where t=x-1.

Special cases:
     acosh(x) is NaN with signal if x<1.
     acosh(NaN) is NaN without signal.
      Parameters:
      x - The number whose inverse hyperbolic cosine is to be returned.
      Returns:
      The inverse hyperbolic cosine of x.
      Since:
      24.1

    • atanh

      public static double atanh(double x)
      Computes the inverse (area) hyperbolic tangent (atanh) of a double value. 
      
__ieee754_atanh(x); derived from fdlibm (e_atanh.c)
Method :
   1.Reduced x to positive by atanh(-x) = -atanh(x)
   2.For x>=0.5
                 1              2x                          x
     atanh(x) = --- * log(1 + -------) = 0.5 * log1p(2 * --------)
                 2             1 - x                      1 - x

     For x<0.5
     atanh(x) = 0.5*log1p(2x+2x*x/(1-x))

Special cases:
     atanh(x) is NaN if |x| > 1 with signal;
     atanh(NaN) is that NaN with no signal;
     atanh(+-1) is +-INF with signal.
      Parameters:
      x - The number whose inverse hyperbolic tangent is to be returned.
      Returns:
      The inverse hyperbolic tangent of x.
      Since:
      24.1