math.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,534 行 · 第 1/5 页
HTML
1,534 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_03) on Wed Nov 02 09:48:29 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>Math (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.lang.Math class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="Math (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_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></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/Math.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="Long.html" title="java.lang 中的类"><B>上一个类</B></A> <A HREF="NegativeArraySizeException.html" title="java.lang 中的类"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../index.html@java_2Flang_2FMath.html" target="_top"><B>框架</B></A> <A HREF="Math.html" target="_top"><B>无框架</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../allclasses-noframe.html"><B>所有类</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../allclasses-noframe.html"><B>所有类</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> 摘要： 嵌套 | <A HREF="#field_summary">字段</A> | 构造方法 | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： <A HREF="#field_detail">字段</A> | 构造方法 | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.lang</FONT><BR>类 Math</H2><PRE><A HREF="Object.html" title="java.lang 中的类">java.lang.Object</A> <IMG SRC="../../resources/inherit.gif" ALT="继承者 "><B>java.lang.Math</B></PRE><HR><DL><DT><PRE>public final class <B>Math</B><DT>extends <A HREF="Object.html" title="java.lang 中的类">Object</A></DL></PRE><P><code>Math</code> 类包含执行初等指数、对数、平方根及三角函数等这些基本数值操作所用的方法。 <p>与 <code>StrictMath</code> 类的某些数值方法不同，并不是 <code>Math</code> 类的所有等效函数的实现都定义为返回逐位相同的结果。这一宽限允许在不要求严格可重复性的地方实现更好的性能。 <p>默认情况下，很多 <code>Math</code> 方法仅调用 <code>StrictMath</code> 中的等效方法来完成它们的实现。建议让代码生成器使用特定于平台的本机库或者使用微处理器指令（如果适用），以提供对 <code>Math</code> 方法的更高性能的实现。这种更高性能的实现仍然必须遵守 <code>Math</code> 的规范。 <p>实现规范的质量涉及到两种属性，即返回结果的准确性和方法的单调性。浮点 <code>Math</code> 方法的准确性根据 <i>ulp</i>（units in the last place，最后一位的进退位）来衡量。对于一个给定的浮点格式，特定实数值的 ulp 是与之最接近的较大浮点值与该值的差。当作为整体而不是针对具体的参数讨论方法的准确性时，引用的 ulp 数值是针对任意参数的最差情况下的误差。如果一个方法的误差总是小于 0.5 ulp，则该方法始终返回最接近准确结果的浮点数；这种方法就是<i>正确舍入</i>。一种正确舍入的方法通常能得到最佳的浮点近似值，然而，对于很多浮点方法来说，进行正确的舍入有些不切实际。相反，对于 <code>Math</code> 类来说，有些方法允许误差在 1 或 2 ulp 的范围内。在非正式情况下，对于 1 ulp 的误差范围，当准确结果是可表示的数值时，应该按照计算结果返回准确结果；否则，将返回准确结果与最接近准确结果的这两个浮点值中的任何一个值。对于值很大的准确结果，接近它的一端可以是无穷大。除了个别参数的准确性之外，维护不同参数的方法之间的正确关系也很重要。因此，大多数误差大于 0.5 ulp 的方法都要求是<i>半单调的</i>：只要数学函数是非递减的，浮点近似值就是非递减的；同样地，只要数学函数是非递增的，浮点近似值就是非递增的。不是所有准确性为 1 ulp 的近似值都能自动满足单调性要求。<P><P><DL><DT><B>从以下版本开始：</B></DT> <DD>JDK1.0</DD></DL><HR><P><!-- =========== FIELD SUMMARY =========== --><A NAME="field_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>字段摘要</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#E">E</A></B></CODE><BR> 比任何其他值更接近于自然对数底数 <i>e</i> 的 <code>double</code> 值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#PI">PI</A></B></CODE><BR> 比任何其他值更接近圆的周长与直径之比 <i>pi</i> 的 <code>double</code> 值。</TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>方法摘要</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#abs(double)">abs</A></B>(double a)</CODE><BR> 返回 <code>double</code> 值的绝对值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static float</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#abs(float)">abs</A></B>(float a)</CODE><BR> 返回 <code>float</code> 值的绝对值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#abs(int)">abs</A></B>(int a)</CODE><BR> 返回 <code>int</code> 值的绝对值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static long</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#abs(long)">abs</A></B>(long a)</CODE><BR> 返回 <code>long</code> 值的绝对值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#acos(double)">acos</A></B>(double a)</CODE><BR> 返回角的反余弦，范围在 0.0 到 <i>pi</i> 之间。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#asin(double)">asin</A></B>(double a)</CODE><BR> 返回角的反正弦，范围在 -<i>pi</i>/2 到 <i>pi</i>/2 之间。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#atan(double)">atan</A></B>(double a)</CODE><BR> 返回角的反正切，范围在 -<i>pi</i>/2 到 <i>pi</i>/2 之间。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#atan2(double, double)">atan2</A></B>(double y, double x)</CODE><BR> 将矩形坐标 (<code>x</code>, <code>y</code>) 转换成极坐标 (r, <i>theta</i>)。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#cbrt(double)">cbrt</A></B>(double a)</CODE><BR> 返回 <code>double</code> 值的立方根。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#ceil(double)">ceil</A></B>(double a)</CODE><BR> 返回最小的（最接近负无穷大）<code>double</code> 值，该值大于或等于参数，并且等于某个整数。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#cos(double)">cos</A></B>(double a)</CODE><BR> 返回角的三角余弦。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#cosh(double)">cosh</A></B>(double x)</CODE><BR> 返回 <code>double</code> 值的双曲线余弦。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#exp(double)">exp</A></B>(double a)</CODE><BR> 返回欧拉数 <i>e</i> 的 <code>double</code> 次幂的值。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#expm1(double)">expm1</A></B>(double x)</CODE><BR> 返回 <i>e</i><sup>x</sup> -1。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#floor(double)">floor</A></B>(double a)</CODE><BR> 返回最大的（最接近正无穷大）<code>double</code> 值，该值小于或等于参数，并且等于某个整数。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#hypot(double, double)">hypot</A></B>(double x, double y)</CODE><BR> 返回 sqrt(<i>x</i><sup>2</sup> +<i>y</i><sup>2</sup>)，没有中间溢出或下溢。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#IEEEremainder(double, double)">IEEEremainder</A></B>(double f1, double f2)</CODE><BR> 按照 IEEE 754 标准的规定，对两个参数进行余数运算。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#log(double)">log</A></B>(double a)</CODE><BR> 返回（底数是 <i>e</i>）<code>double</code> 值的自然对数。</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static double</CODE></FONT></TD><TD><CODE><B><A HREF="Math.html#log10(double)">log10</A></B>(double a)</CODE><BR> 返回 <code>double</code> 值的底数为 10 的对数。</TD></TR>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?