math.html

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

<li>如果参数是零，那么结果是零，符号与参数符号相同。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 以弧度表示的角。
<DT><B>返回：</B><DD>参数的正切。</DL>
</DD>
</DL>
<HR>

<A NAME="asin(double)"><!-- --></A><H3>
asin</H3>
<PRE>
public static double <B>asin</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回角的反正弦，范围在 -<i>pi</i>/2 到 <i>pi</i>/2 之间。特殊情况是：
<ul><li>如果参数是 NaN 或它的绝对值大于 1，那么结果是 NaN。
<li>如果参数是零，那么结果是零，符号与参数符号相同。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 要返回其反正弦的值。
<DT><B>返回：</B><DD>参数的反正弦。</DL>
</DD>
</DL>
<HR>

<A NAME="acos(double)"><!-- --></A><H3>
acos</H3>
<PRE>
public static double <B>acos</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回角的反余弦，范围在 0.0 到 <i>pi</i> 之间。特殊情况是：
<ul><li>如果参数是 NaN 或它的绝对值大于 1，那么结果是 NaN。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 要返回其反余弦的值。
<DT><B>返回：</B><DD>参数的反余弦。</DL>
</DD>
</DL>
<HR>

<A NAME="atan(double)"><!-- --></A><H3>
atan</H3>
<PRE>
public static double <B>atan</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回角的反正切，范围在 -<i>pi</i>/2 到 <i>pi</i>/2 之间。特殊情况是： 
<ul><li>如果参数是 NaN，那么结果是 NaN。
<li>如果参数是零，那么结果是零，符号与参数符号相同。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 要返回其反正切的值。
<DT><B>返回：</B><DD>参数的反正切。</DL>
</DD>
</DL>
<HR>

<A NAME="toRadians(double)"><!-- --></A><H3>
toRadians</H3>
<PRE>
public static double <B>toRadians</B>(double&nbsp;angdeg)</PRE>
<DL>
<DD>将用度数测量的角转换为近似相等的用弧度测量的角。从度数到弧度的转换通常是不精确的。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>angdeg</CODE> - 用度数表示的角
<DT><B>返回：</B><DD>角 <code>angrad</code> 的弧度值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="toDegrees(double)"><!-- --></A><H3>
toDegrees</H3>
<PRE>
public static double <B>toDegrees</B>(double&nbsp;angrad)</PRE>
<DL>
<DD>将用弧度测量的角转换为近似相等的用度数测量的角。从弧度到度数的转换通常是不精确的；用户<i>不</i> 应该期望 <code>cos(toRadians(90.0))</code> 与 <code>0.0</code> 精确相等。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>angrad</CODE> - 用弧度表示的角。
<DT><B>返回：</B><DD>角 <code>angrad</code> 的角度值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="exp(double)"><!-- --></A><H3>
exp</H3>
<PRE>
public static double <B>exp</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回欧拉数 <i>e</i> 的 <code>double</code> 次幂的值。特殊情况是：
<ul><li>如果参数是 NaN，那么结果就是 NaN。
<li>如果参数是正无穷大，那么结果就是正无穷大。
<li>如果参数是负无穷大，那么结果就是正零。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - <i>e</i> 的指数。
<DT><B>返回：</B><DD>值 <i>e</i><sup><code>a</code></sup>，其中 <i>e</i> 是自然对数的底数。</DL>
</DD>
</DL>
<HR>

<A NAME="log(double)"><!-- --></A><H3>
log</H3>
<PRE>
public static double <B>log</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回（底数是 <i>e</i>）<code>double</code> 值的自然对数。特殊情况是：
<ul><li>如果参数是 NaN 或小于零，那么结果是 NaN。
<li>如果参数是正无穷大，那么结果就是正无穷大。
<li>如果参数是正零或负零，那么结果是负无穷大。</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值
<DT><B>返回：</B><DD>ln&nbsp;<code>a</code> 的值，<code>a</code> 的自然对数。</DL>
</DD>
</DL>
<HR>

<A NAME="log10(double)"><!-- --></A><H3>
log10</H3>
<PRE>
public static double <B>log10</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回 <code>double</code> 值的底数为 10 的对数。特殊情况是：

<ul><li>如果参数是 NaN 或小于零，那么结果是 NaN。
<li>如果参数是正无穷大，那么结果就是正无穷大。
<li>如果参数是正零或负零，那么结果是负无穷大。
<li> 如果参数等于整数 <i>n</i> 的 10 <sup><i>n</i></sup>，那么结果是 <i>n</i>。
</ul>
 
<p>计算结果必须在准确结果的 1 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值
<DT><B>返回：</B><DD><code>a</code> 的底数为 10 的对数。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="sqrt(double)"><!-- --></A><H3>
sqrt</H3>
<PRE>
public static double <B>sqrt</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回正确舍入的 <code>double</code> 值的正平方根。特殊情况是：
<ul><li>如果参数是 NaN 或小于零，那么结果是 NaN。
<li>如果参数是正无穷大，那么结果就是正无穷大。
<li>如果参数是正零或负零，那么结果与参数相同。</ul>
否则，结果是最接近该参数值的真实数学平方根的 <code>double</code> 值。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值。
<DT><B>返回：</B><DD><code>a</code> 的正平方根。
如果参数是 NaN 或小于零，那么结果是 NaN。</DL>
</DD>
</DL>
<HR>

<A NAME="cbrt(double)"><!-- --></A><H3>
cbrt</H3>
<PRE>
public static double <B>cbrt</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回 <code>double</code> 值的立方根。对于正的有限值 <code>x</code>，<code>cbrt(-x) == -cbrt(x)</code>；也就是说，负值的立方根是该值大小的负立方根。特殊情况是： 

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

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

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

<p>计算结果必须在准确结果的 1 ulp 范围内。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值。
<DT><B>返回：</B><DD><code>a</code> 的立方根。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="IEEEremainder(double, double)"><!-- --></A><H3>
IEEEremainder</H3>
<PRE>
public static double <B>IEEEremainder</B>(double&nbsp;f1,
                                   double&nbsp;f2)</PRE>
<DL>
<DD>按照 IEEE 754 标准的规定，对两个参数进行余数运算。余数的算术值等于 <code>f1&nbsp;-&nbsp;f2</code>&nbsp;&times;&nbsp;<i>n</i>，其中 <i>n</i> 是最接近 <code>f1/f2</code> 的商的准确算术值的整数，如果两个整数都同样接近 <code>f1/f2</code>，那么 <i>n</i> 是其中的偶数。如果余数是零，则它的符号与第一个参数的符号相同。特殊情况是：
<ul><li>如果两个参数都是 NaN，或者第一个参数是无穷大，或者第二个参数是正零或负零，那么结果是 NaN。
<li>如果第一个参数是有限值，第二个参数是无穷大，那么结果与第一个参数相同。</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f1</CODE> - 被除数。<DD><CODE>f2</CODE> - 除数。
<DT><B>返回：</B><DD><code>f1</code> 除以 <code>f2</code> 的余数。</DL>
</DD>
</DL>
<HR>

<A NAME="ceil(double)"><!-- --></A><H3>
ceil</H3>
<PRE>
public static double <B>ceil</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回最小的（最接近负无穷大）<code>double</code> 值，该值大于或等于参数，并且等于某个整数。特殊情况是：
<ul><li>如果参数值已经等于某个整数，那么结果与该参数相同。<li>如果参数是 NaN、无穷大、正零或负零，那么结果与参数相同。<li>如果参数值小于零，但是大于 -1.0，那么结果是负零。</ul> 注意，<code>Math.ceil(x)</code> 的值与 <code>-Math.floor(-x)</code> 的值完全相同。
<p>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值。
<DT><B>返回：</B><DD>最小（最接近负无穷大）浮点值，该值大于或等于该参数，并且等于某个整数。</DL>
</DD>
</DL>
<HR>

<A NAME="floor(double)"><!-- --></A><H3>
floor</H3>
<PRE>
public static double <B>floor</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回最大的（最接近正无穷大）<code>double</code> 值，该值小于或等于参数，并且等于某个整数。特殊情况是：
<ul><li>如果参数值已经等于某个整数，那么结果与该参数相同。<li>如果参数是 NaN、无穷大、正零或负零，那么结果与参数相同。</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - 一个值。
<DT><B>返回：</B><DD>最大（最接近正无穷大）浮点值，该值小于或等于该参数，并且等于某个整数。</DL>
</DD>
</DL>
<HR>

<A NAME="rint(double)"><!-- --></A><H3>
rint</H3>
<PRE>
public static double <B>rint</B>(double&nbsp;a)</PRE>
<DL>
<DD>返回其值最接近参数并且是整数的 <code>double</code> 值。如果两个整数的 <code>double</code> 值都同样接近，那么结果取偶数。特殊情况是：
<ul><li>如果参数值是整数，那么结果就是该参数。 
<li>如果参数是 NaN 或无穷大或正零或负零，那么结果与参数相同。</ul>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>a</CODE> - <code>double</code> 值。
<DT><B>返回：</B><DD>最接近 <code>a</code> 的整数浮点值。</DL>
</DD>
</DL>
<HR>

<A NAME="atan2(double, double)"><!-- --></A><H3>
atan2</H3>
<PRE>
public static double <B>atan2</B>(double&nbsp;y,
                           double&nbsp;x)</PRE>
<DL>
<DD>将矩形坐标 (<code>x</code>,&nbsp;<code>y</code>) 转换成极坐标 (r,&nbsp;<i>theta</i>)。该方法通过计算 <code>y/x</code> 的反正切值来计算相 (phase) <i>theta</i>，范围为从 -<i>pi</i> 到 <i>pi</i>。特殊情况是：
<ul><li>如果两个参数都是 NaN，那么结果是 NaN。 
<li>如果第一个参数是正零，第二个参数是正数；或者第一个参数是正的有限值，第二个参数是正的无穷大，那么结果是正零。 
<li>如果第一个参数是负零，第二个参数是正数；或者第一个参数是负的有限值，第二个参数是正的无穷大，那么结果是负零。 
<li>如果第一个参数是正零，第二个参数是负数；或者第一个参数是正的有限值，第二个参数是负的无穷大，那么结果是最接近 <i>pi</i> 的 <code>double</code> 值。 
<li>如果第一个参数是正零，第二个参数是负数；或者第一个参数是负的有限值，第二个参数是负的无穷大，那么结果是最接近 <i>pi</i> 的 <code>double</code> 值。 
<li>如果第一个参数是正数，第二个参数是正零或负零；或者第一个参数是正的无穷大，第二个参数是有限值，那么结果是最接近 <i>pi</i>/2 的 <code>double</code> 值。
<li>如果第一个参数是负数，第二个参数是正零或负零；或者第一个参数是负的无穷大，第二个参数是有限值，那么结果是最接近 -<i>pi</i>/2 的 <code>double</code> 值。
<li>如果两个参数都是正的无穷大，那么结果是最接近 <i>pi</i>/4 的 <code>double</code> 值。
<li>如果第一个参数是正的无穷大，第二个参数是负的无穷大，那么结果是最接近 3*<i>pi</i>/4 的 <code>double</code> 值。
<li>如果第一个参数是负的无穷大，第二个参数是正的无穷大，那么结果是最接近 -<i>pi</i>/4 的 <code>double</code> 值。
<li>如果两个参数都是负的无穷大，那么结果是最接近 -3*<i>pi</i>/4 的 <code>double</code> 值。</ul>
 
<p>计算结果必须在准确结果的 2 ulp 范围内。结果必须具有半单调性。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>y</CODE> - 纵坐标<DD><CODE>x</CODE> - 横坐标
<DT><B>返回：</B><DD>与笛卡儿坐标中点 (<i>x</i>,&nbsp;<i>y</i>) 对应的极坐标中点 (<i>r</i>,&nbsp;<i>theta</i>) 的 <i>theta</i> 部分。</DL>
</DD>
</DL>
<HR>

<A NAME="pow(double, double)"><!-- --></A><H3>
pow</H3>
<PRE>
public static double <B>pow</B>(double&nbsp;a,
                         double&nbsp;b)</PRE>
<DL>
<DD>返回第一个参数的第二个参数次幂的值。特殊情况是：

<ul><li>如果第二个参数是正零或负零，那么结果是 1.0。
<li>如果第二个参数是 1.0，那么结果与第一个参数相同。