< prev index next >

src/java.base/share/classes/java/lang/StrictMath.java

Print this page




 290      * -cbrt(x)}; that is, the cube root of a negative value is
 291      * the negative of the cube root of that value's magnitude.
 292      * Special cases:
 293      *
 294      * <ul>
 295      *
 296      * <li>If the argument is NaN, then the result is NaN.
 297      *
 298      * <li>If the argument is infinite, then the result is an infinity
 299      * with the same sign as the argument.
 300      *
 301      * <li>If the argument is zero, then the result is a zero with the
 302      * same sign as the argument.
 303      *
 304      * </ul>
 305      *
 306      * @param   a   a value.
 307      * @return  the cube root of {@code a}.
 308      * @since 1.5
 309      */
 310     public static native double cbrt(double a);


 311 
 312     /**
 313      * Computes the remainder operation on two arguments as prescribed
 314      * by the IEEE 754 standard.
 315      * The remainder value is mathematically equal to
 316      * <code>f1&nbsp;-&nbsp;f2</code>&nbsp;&times;&nbsp;<i>n</i>,
 317      * where <i>n</i> is the mathematical integer closest to the exact
 318      * mathematical value of the quotient {@code f1/f2}, and if two
 319      * mathematical integers are equally close to {@code f1/f2},
 320      * then <i>n</i> is the integer that is even. If the remainder is
 321      * zero, its sign is the same as the sign of the first argument.
 322      * Special cases:
 323      * <ul><li>If either argument is NaN, or the first argument is infinite,
 324      * or the second argument is positive zero or negative zero, then the
 325      * result is NaN.
 326      * <li>If the first argument is finite and the second argument is
 327      * infinite, then the result is the same as the first argument.</ul>
 328      *
 329      * @param   f1   the dividend.
 330      * @param   f2   the divisor.




 290      * -cbrt(x)}; that is, the cube root of a negative value is
 291      * the negative of the cube root of that value's magnitude.
 292      * Special cases:
 293      *
 294      * <ul>
 295      *
 296      * <li>If the argument is NaN, then the result is NaN.
 297      *
 298      * <li>If the argument is infinite, then the result is an infinity
 299      * with the same sign as the argument.
 300      *
 301      * <li>If the argument is zero, then the result is a zero with the
 302      * same sign as the argument.
 303      *
 304      * </ul>
 305      *
 306      * @param   a   a value.
 307      * @return  the cube root of {@code a}.
 308      * @since 1.5
 309      */
 310     public static double cbrt(double a) {
 311         return FdLibm.Cbrt.compute(a);
 312     }
 313 
 314     /**
 315      * Computes the remainder operation on two arguments as prescribed
 316      * by the IEEE 754 standard.
 317      * The remainder value is mathematically equal to
 318      * <code>f1&nbsp;-&nbsp;f2</code>&nbsp;&times;&nbsp;<i>n</i>,
 319      * where <i>n</i> is the mathematical integer closest to the exact
 320      * mathematical value of the quotient {@code f1/f2}, and if two
 321      * mathematical integers are equally close to {@code f1/f2},
 322      * then <i>n</i> is the integer that is even. If the remainder is
 323      * zero, its sign is the same as the sign of the first argument.
 324      * Special cases:
 325      * <ul><li>If either argument is NaN, or the first argument is infinite,
 326      * or the second argument is positive zero or negative zero, then the
 327      * result is NaN.
 328      * <li>If the first argument is finite and the second argument is
 329      * infinite, then the result is the same as the first argument.</ul>
 330      *
 331      * @param   f1   the dividend.
 332      * @param   f2   the divisor.


< prev index next >