math.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,534 行 · 第 1/5 页

public static float <B>min</B>(float&nbsp;a,
                        float&nbsp;b)</PRE>
<DL>
<DD>返回两个 <code>float</code> 值中较小的一个。也就是说，结果是更接近负无穷大的值。如果参数值相同，则结果是这个相同值。如果两个值都是 NaN，那么结果就是 NaN。与数值比较运算不同，该方法认为负零严格小于正零。如果一个参数是正零，另一个参数是负零，那么结果是负零。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 参数。<DD><CODE>b</CODE> - 另一个参数。
<DT><B>返回：</B><DD><code>a</code> 和 <code>b</code> 中的较小者。</DL>
</DD>
</DL>
<HR>

<A NAME="min(double, double)"><!-- --></A><H3>
min</H3>
<PRE>
public static double <B>min</B>(double&nbsp;a,
                         double&nbsp;b)</PRE>
<DL>
<DD>返回两个 <code>double</code> 值中较小的一个。也就是说，结果是更接近负无穷大的值。如果参数值相同，则结果是这个相同值。如果两个值都是 NaN，那么结果就是 NaN。与数值比较运算不同，该方法认为负零严格小于正零。如果一个参数是正零，另一个参数是负零，那么结果是负零。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 参数。<DD><CODE>b</CODE> - 另一个参数。
<DT><B>返回：</B><DD><code>a</code> 和 <code>b</code> 中的较小者。</DL>
</DD>
</DL>
<HR>

<A NAME="ulp(double)"><!-- --></A><H3>
ulp</H3>
<PRE>
public static double <B>ulp</B>(double&nbsp;d)</PRE>
<DL>
<DD>返回参数的 ulp 大小。<code>double</code> 值的 ulp 是该浮点值与下一个较大 <code>double</code> 值之间的正距离。注意，对于非 NaN <i>x</i>，<code>ulp(-<i>x</i>) == ulp(<i>x</i>)</code>。
 
<p>特殊情况是：
<ul>
<li> 如果参数是 NaN，那么结果就是 NaN。
<li> 如果参数是正的或负的无穷大，那么结果是正无穷大。
<li> 如果参数是正零或负零，那么结果是 <code>Double.MIN_VALUE</code>。
<li> 如果参数是 &plusmn;<code>Double.MAX_VALUE</code>，那么结果等于 2<sup>971</sup>。
</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>d</CODE> - 要返回 ulp 的浮点值
<DT><B>返回：</B><DD>参数的 ulp 大小<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="ulp(float)"><!-- --></A><H3>
ulp</H3>
<PRE>
public static float <B>ulp</B>(float&nbsp;f)</PRE>
<DL>
<DD>返回参数的 ulp 大小。<code>float</code> 值的 ulp 是该浮点值与下一个较大 <code>float</code> 值之间的正距离。注意，对于非 NaN <i>x</i>，<code>ulp(-<i>x</i>) == ulp(<i>x</i>)</code>。
 
<p>特殊情况是：
<ul>
<li> 如果参数是 NaN，那么结果就是 NaN。
<li> 如果参数是正的或负的无穷大，那么结果是正无穷大。
<li> 如果参数是正零或负零，那么结果是 <code>Float.MIN_VALUE</code>。
<li> 如果参数是 &plusmn;<code>Float.MAX_VALUE</code>，那么结果等于 2<sup>104</sup>。
</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f</CODE> - 要返回 ulp 的浮点值
<DT><B>返回：</B><DD>参数的 ulp 大小<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="signum(double)"><!-- --></A><H3>
signum</H3>
<PRE>
public static double <B>signum</B>(double&nbsp;d)</PRE>
<DL>
<DD>返回参数的符号函数；如果参数是零，则返回零；如果参数大于零，则返回 1.0；如果参数小于零，则返回 -1.0。

<p>特殊情况是：
<ul>
<li> 如果参数是 NaN，那么结果就是 NaN。
<li> 如果参数是正零或负零，那么结果与参数相同。
</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>d</CODE> - 要返回符号函数的浮点值
<DT><B>返回：</B><DD>参数的符号函数<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="signum(float)"><!-- --></A><H3>
signum</H3>
<PRE>
public static float <B>signum</B>(float&nbsp;f)</PRE>
<DL>
<DD>返回参数的符号函数；如果参数是零，则返回零；如果参数大于零，则返回 1.0；如果参数小于零，则返回 -1.0。

<p>特殊情况是：
<ul>
<li> 如果参数是 NaN，那么结果就是 NaN。
<li> 如果参数是正零或负零，那么结果与参数相同。
</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f</CODE> - 要返回符号函数的浮点值
<DT><B>返回：</B><DD>参数的符号函数<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="sinh(double)"><!-- --></A><H3>
sinh</H3>
<PRE>
public static double <B>sinh</B>(double&nbsp;x)</PRE>
<DL>
<DD>返回 <code>double</code> 值的双曲线正弦。<i>x</i> 的双曲线正弦的定义是 (<i>e<sup>x</sup>&nbsp;-&nbsp;e<sup>-x</sup></i>)/2，其中 <i>e</i> 是 <A HREF="Math.html#E">欧拉数</A>。

<p>特殊情况是：
<ul>

<li>如果参数是 NaN，那么结果就是 NaN。

<li>如果参数是无穷大，那么结果是无穷大，且符号与参数符号相同。

<li>如果参数是零，那么结果是零，符号与参数符号相同。

</ul>

<p>计算结果必须在准确结果的 2.5 ulp 范围内。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 要返回其双曲线正弦的数字。
<DT><B>返回：</B><DD><code>x</code> 的双曲线正弦。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="cosh(double)"><!-- --></A><H3>
cosh</H3>
<PRE>
public static double <B>cosh</B>(double&nbsp;x)</PRE>
<DL>
<DD>返回 <code>double</code> 值的双曲线余弦。<i>x</i> 的双曲线余弦的定义是 (<i>e<sup>x</sup>&nbsp;+&nbsp;e<sup>-x</sup></i>)/2，其中 <i>e</i> 是 <A HREF="Math.html#E">欧拉数</A>。

<p>特殊情况是：
<ul>

<li>如果参数是 NaN，那么结果就是 NaN。

<li>如果参数是无穷大，那么结果是正无穷大。

<li>如果参数是零，那么结果是 <code>1.0</code>。

</ul>

<p>计算结果必须在准确结果的 2.5 ulp 范围内。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 要返回其双曲线余弦的数字。
<DT><B>返回：</B><DD><code>x</code> 的双曲线余弦。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="tanh(double)"><!-- --></A><H3>
tanh</H3>
<PRE>
public static double <B>tanh</B>(double&nbsp;x)</PRE>
<DL>
<DD>返回 <code>double</code> 值的双曲线余弦。<i>x</i> 的双曲线正切的定义是 (<i>e<sup>x</sup>&nbsp;-&nbsp;e<sup>-x</sup></i>)/(<i>e<sup>x</sup>&nbsp;+&nbsp;e<sup>-x</sup></i>)，即 <A HREF="Math.html#sinh(double)">sinh(<i>x</i>)</A>/<A HREF="Math.html#cosh(double)">cosh(<i>x</i>)</A>。注意，准确的双曲正切绝对值始终小于 1。

<p>特殊情况是：
<ul>

<li>如果参数是 NaN，那么结果就是 NaN。

<li>如果参数是零，那么结果是零，符号与参数符号相同。

<li>如果参数是正无穷大，那么结果是 <code>+1.0</code>。

<li>如果参数是负无穷大，那么结果是 <code>-1.0</code>。
  
</ul>

<p>计算结果必须在准确结果的 2.5 ulp 范围内。对于任何有限的输入，其 <code>tanh</code> 结果的绝对值必定小于或等于 1。注意，一旦准确的双曲正切结果在极限值 &plusmn;1 的 1/2 ulp 内，则应该返回有正确符号的 &plusmn;<code>1.0</code>。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 要返回其双曲线正切的数字。
<DT><B>返回：</B><DD><code>x</code> 的双曲线正切。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="hypot(double, double)"><!-- --></A><H3>
hypot</H3>
<PRE>
public static double <B>hypot</B>(double&nbsp;x,
                           double&nbsp;y)</PRE>
<DL>
<DD>返回 sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)，没有中间溢出或下溢。

<p>特殊情况是：
<ul>

<li> 如果任何一个参数是无穷大，那么结果就是正无穷大。

<li> 如果任何一个参数是 NaN 且都不是无穷大，那么结果是 NaN。

</ul>

<p>计算结果必须在准确结果的 1 ulp 范围内。如果一个参数保存常量，那么在另一个参数中，结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 一个值<DD><CODE>y</CODE> - 一个值
<DT><B>返回：</B><DD>sqrt(<i>x</i><sup>2</sup>&nbsp;+<i>y</i><sup>2</sup>)，没有中间溢出或下溢<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="expm1(double)"><!-- --></A><H3>
expm1</H3>
<PRE>
public static double <B>expm1</B>(double&nbsp;x)</PRE>
<DL>
<DD>返回 <i>e</i><sup>x</sup>&nbsp;-1。注意，对于接近零的 <i>x</i> 值，<code>expm1(x)</code>&nbsp;+&nbsp;1 的准确和比 <code>exp(x)</code> 更接近 <i>e</i><sup>x</sup> 的真实结果。

<p>特殊情况是：
<ul>
<li>如果参数是 NaN，那么结果就是 NaN。

<li>如果参数是正无穷大，那么结果就是正无穷大。

<li>如果参数是负无穷大，那么结果是 -1.0。

<li>如果参数是零，那么结果是零，符号与参数符号相同。

</ul>

<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。对于任何有限的输入，<code>expm1</code> 的结果一定大于或等于 <code>-1.0</code>。注意，一旦 <i>e</i><sup><code>x</code></sup>&nbsp;-&nbsp;1 的准确结果在极限值 -1 的 1/2 ulp 范围内，则应该返回 <code>-1.0</code>。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 在 <i>e</i><sup><code>x</code></sup>&nbsp;1 的计算中 <i>e</i> 的指数。
<DT><B>返回：</B><DD>值 <i>e</i><sup><code>x</code></sup>&nbsp;-&nbsp;1。</DL>
</DD>
</DL>
<HR>

<A NAME="log1p(double)"><!-- --></A><H3>
log1p</H3>
<PRE>
public static double <B>log1p</B>(double&nbsp;x)</PRE>
<DL>
<DD>返回参数与 1 的和的自然对数。注意，对于小的 <code>x</code> 值，<code>log1p(x)</code> 的结果比 <code>log(1.0+x)</code> 的浮点计算结果更接近 ln(1 + <code>x</code>) 的真实结果。

<p>特殊情况是：

<ul>

<li>如果参数是 NaN 或小于 -1，那么结果是 NaN。

<li>如果参数是正无穷大，那么结果就是正无穷大。

<li>如果参数是负数，那么结果是负无穷大。

<li>如果参数是零，那么结果是零，符号与参数符号相同。

</ul>

<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>x</CODE> - 一个值
<DT><B>返回：</B><DD>ln(<code>x</code>&nbsp;+&nbsp;1) 的值，<code>x</code>&nbsp;+&nbsp;1 的自然对数</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></