< prev index next >

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

Print this page




1312      * Returns sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)
1313      * without intermediate overflow or underflow.
1314      *
1315      * <p>Special cases:
1316      * <ul>
1317      *
1318      * <li> If either argument is infinite, then the result
1319      * is positive infinity.
1320      *
1321      * <li> If either argument is NaN and neither argument is infinite,
1322      * then the result is NaN.
1323      *
1324      * </ul>
1325      *
1326      * @param x a value
1327      * @param y a value
1328      * @return sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)
1329      * without intermediate overflow or underflow
1330      * @since 1.5
1331      */
1332     public static native double hypot(double x, double y);


1333 
1334     /**
1335      * Returns <i>e</i><sup>x</sup>&nbsp;-1.  Note that for values of
1336      * <i>x</i> near 0, the exact sum of
1337      * {@code expm1(x)}&nbsp;+&nbsp;1 is much closer to the true
1338      * result of <i>e</i><sup>x</sup> than {@code exp(x)}.
1339      *
1340      * <p>Special cases:
1341      * <ul>
1342      * <li>If the argument is NaN, the result is NaN.
1343      *
1344      * <li>If the argument is positive infinity, then the result is
1345      * positive infinity.
1346      *
1347      * <li>If the argument is negative infinity, then the result is
1348      * -1.0.
1349      *
1350      * <li>If the argument is zero, then the result is a zero with the
1351      * same sign as the argument.
1352      *




1312      * Returns sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)
1313      * without intermediate overflow or underflow.
1314      *
1315      * <p>Special cases:
1316      * <ul>
1317      *
1318      * <li> If either argument is infinite, then the result
1319      * is positive infinity.
1320      *
1321      * <li> If either argument is NaN and neither argument is infinite,
1322      * then the result is NaN.
1323      *
1324      * </ul>
1325      *
1326      * @param x a value
1327      * @param y a value
1328      * @return sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)
1329      * without intermediate overflow or underflow
1330      * @since 1.5
1331      */
1332     public static double hypot(double x, double y) {
1333         return FdLibm.Hypot.compute(x, y);
1334     }
1335 
1336     /**
1337      * Returns <i>e</i><sup>x</sup>&nbsp;-1.  Note that for values of
1338      * <i>x</i> near 0, the exact sum of
1339      * {@code expm1(x)}&nbsp;+&nbsp;1 is much closer to the true
1340      * result of <i>e</i><sup>x</sup> than {@code exp(x)}.
1341      *
1342      * <p>Special cases:
1343      * <ul>
1344      * <li>If the argument is NaN, the result is NaN.
1345      *
1346      * <li>If the argument is positive infinity, then the result is
1347      * positive infinity.
1348      *
1349      * <li>If the argument is negative infinity, then the result is
1350      * -1.0.
1351      *
1352      * <li>If the argument is zero, then the result is a zero with the
1353      * same sign as the argument.
1354      *


< prev index next >