float.html

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

<DD><DL>

<DT><B>返回：</B><DD>这个对象所表示的 <code>float</code> 值，该值被转换为 <code>int</code> 类型</DL>
</DD>
</DL>
<HR>

<A NAME="longValue()"><!-- --></A><H3>
longValue</H3>
<PRE>
public long <B>longValue</B>()</PRE>
<DL>
<DD>返回这个 <code>Float</code> 值对应的 <code>long</code> 值（它被强制转换为一个 <code>long</code>）。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="Number.html" title="java.lang 中的类">Number</A></CODE> 中的 <CODE><A HREF="Number.html#longValue()">longValue</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>这个对象所表示的 <code>float</code> 值，该值被转换为 <code>long</code> 类型</DL>
</DD>
</DL>
<HR>

<A NAME="floatValue()"><!-- --></A><H3>
floatValue</H3>
<PRE>
public float <B>floatValue</B>()</PRE>
<DL>
<DD>返回这个 <code>Float</code> 对象的 <code>float</code> 值。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="Number.html" title="java.lang 中的类">Number</A></CODE> 中的 <CODE><A HREF="Number.html#floatValue()">floatValue</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>这个对象所表示的 <code>float</code> 值。</DL>
</DD>
</DL>
<HR>

<A NAME="doubleValue()"><!-- --></A><H3>
doubleValue</H3>
<PRE>
public double <B>doubleValue</B>()</PRE>
<DL>
<DD>返回这个 <code>Float</code> 对象的 <code>double</code> 值。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="Number.html" title="java.lang 中的类">Number</A></CODE> 中的 <CODE><A HREF="Number.html#doubleValue()">doubleValue</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>这个对象所表示的 <code>float</code> 值被转换为 <code>double</code> 类型的值，并返回转换的结果。</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回这个 <code>Float</code> 对象的哈希代码。结果是这个 <code>Float</code> 对象表示的基本 <code>float</code> 值的整数位表示，与 <A HREF="Float.html#floatToIntBits(float)"><CODE>floatToIntBits(float)</CODE></A> 方法产生的结果非常类似。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#hashCode()">hashCode</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>这个对象的哈希代码值。<DT><B>另请参见：</B><DD><A HREF="Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(<A HREF="Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>将这个对象与指定的对象进行比较。当且仅当参数不是 <code>null</code>，而是一个 <code>Float</code> 对象，表示的 <code>float</code> 值与这个对象所表示的 <code>float</code> 值相同时，结果为 <code>true</code>。为此，在应用这两个 <code>float</code> 值时，当且仅当 <A HREF="Float.html#floatToIntBits(float)"><CODE>floatToIntBits(float)</CODE></A> 返回相同的 <code>int</code> 值时，认为这两个值是相同的。
<p>
注意，在大多数情况下，对于 <code>Float</code> 类的两个实例 <code>f1</code> 和 <code>f2</code>，让 <code>f1.equals(f2)</code> 的值为 <code>true</code> 的条件是当且仅当
<blockquote><pre>
f1.floatValue() == f2.floatValue()
</pre></blockquote>
<p>
的值也为 <code>true</code>。但是也有下列两种例外：
<ul>
<li>如果 <code>f1</code> 和 <code>f2</code> 都表示 <code>Float.NaN</code>，那么即使 <code>Float.NaN==Float.NaN</code> 的值为 <code>false</code>，<code>equals</code> 方法也将返回 <code>true</code>。
<li>如果 <code>f1</code> 表示 <code>+0.0f</code>，而 <code>f2</code> 表示 <code>-0.0f</code>，或相反的情况，则 <code>equal</code> 测试返回的值是 <code>false</code>，即使 <code>0.0f==-0.0f</code> 的值为 <code>true</code> 也是如此。
</ul>
该定义能让哈希表得正确操作。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#equals(java.lang.Object)">equals</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要比较的对象
<DT><B>返回：</B><DD>如果对象是相同的，则返回 <code>true</code>；否则返回 <code>false</code>。<DT><B>另请参见：</B><DD><A HREF="Float.html#floatToIntBits(float)"><CODE>floatToIntBits(float)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="floatToIntBits(float)"><!-- --></A><H3>
floatToIntBits</H3>
<PRE>
public static int <B>floatToIntBits</B>(float&nbsp;value)</PRE>
<DL>
<DD>根据 IEEE 754 的浮点&ldquo;单一形式&rdquo;中的位布局，返回指定浮点值的表示形式。
 <p>
第 31 位（掩码 <code>0x80000000</code> 选定的位）表示浮点数字的符号。第 30-23 位（掩码 <code>0x7f800000</code> 选定的位）表示指数。第 22-0 位（掩码 <code>0x007fffff</code> 选定的位）表示浮点数字的有效数（有时也称为尾数）。 
<p>如果参数为正无穷大，则结果为 <code>0x7f800000</code>。 
<p>如果参数为负无穷大，则结果为 <code>0xff800000</code>。 
<p>如果参数为 NaN，则结果为 <code>0x7fc00000</code>。 
<p>
在所有情况下，结果都是一个整数，在将其赋予 <A HREF="Float.html#intBitsToFloat(int)"><CODE>intBitsToFloat(int)</CODE></A> 方法时，将生成一个与 <code>floatToIntBits</code> 的参数相同的浮点值（除所有 NaN 值被折叠成一个&ldquo;规范的&rdquo;NaN 值之外）。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>value</CODE> - 一个浮点数字。
<DT><B>返回：</B><DD>表示浮点数字的位。</DL>
</DD>
</DL>
<HR>

<A NAME="floatToRawIntBits(float)"><!-- --></A><H3>
floatToRawIntBits</H3>
<PRE>
public static int <B>floatToRawIntBits</B>(float&nbsp;value)</PRE>
<DL>
<DD>根据 IEEE 754 的浮点&ldquo;单一形式&rdquo;中的位布局，返回指定浮点值的表示形式，并保留非数字值。
 <p>
第 31 位（掩码 <code>0x80000000</code> 选定的位）表示浮点数字的符号。第 30-23 位（掩码 <code>0x7f800000</code> 选定的位）表示指数。第 22-0 位（掩码 <code>0x007fffff</code> 选定的位）表示浮点数字的有效数（有时也称为尾数）。 
<p>如果参数为正无穷大，则结果为 <code>0x7f800000</code>。 
<p>如果参数为负无穷大，则结果为 <code>0xff800000</code>。
<p>
如果参数为 NaN，则结果是表示实际 NaN 值的整数。与 <code>floatToIntBits</code> 方法不同，<code>intToRawIntBits</code> 并没有折叠那些将 NaN 编码为一个&ldquo;规范的&rdquo;NaN 值的所有位模式。
<p>
在所有情况下，结果都是一个整数，在将其赋予 <A HREF="Float.html#intBitsToFloat(int)"><CODE>intBitsToFloat(int)</CODE></A> 方法时，将生成一个与 <code>floatToRawIntBits</code> 的参数相同的浮点值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>value</CODE> - 一个浮点数字。
<DT><B>返回：</B><DD>表示浮点数字的位。</DL>
</DD>
</DL>
<HR>

<A NAME="intBitsToFloat(int)"><!-- --></A><H3>
intBitsToFloat</H3>
<PRE>
public static float <B>intBitsToFloat</B>(int&nbsp;bits)</PRE>
<DL>
<DD>返回对应于给定的位表示形式的 <code>float</code> 值。该参数被认为是符合 IEEE 754 的浮点&ldquo;单一形式&rdquo;中的位布局规定的浮点值表示形式。
 <p>
如果参数为 <code>0x7f800000</code>，则结果为正无穷大。
 <p>
如果参数为 <code>0xff800000</code>，则结果为负无穷大。
 <p>
如果参数在 <code>0x7f800001</code> 到 <code>0x7fffffff</code> 或在 <code>0xff800001</code> 到 <code>0xffffffff</code> 之间，则结果为 NaN。Java 提供的任何 IEEE 754 浮点操作都不能区分具有不同位模式的同一类型的两个 NaN 值。不同的 NaN 值只能使用 <code>Float.floatToRawIntBits</code> 方法进行区分。
 <p>
在其他所有情况下，都允许 <i>s</i>、<i>e</i> 和 <i>m</i> 作为可以通过以下参数进行计算的三个值； 
 <blockquote><pre>
int s = ((bits &gt;&gt; 31) == 0) ? 1 : -1;
int e = ((bits &gt;&gt; 23) &amp; 0xff);
int m = (e == 0) ?
                (bits &amp; 0x7fffff) &lt;&lt; 1 :
                (bits &amp; 0x7fffff) | 0x800000;
 </pre></blockquote>
浮点结果等于算术表达式 <i>s</i>&middot;<i>m</i>&middot;2<sup><i>e</i>-150</sup> 的值。
<p>
注意，这个方法不能返回具有与 <code>int</code> 参数完全相同的位模式的 <code>float</code> NaN 值。IEEE 754 对静默 NaN 和<i>信号 NaN</i> 这两种 NaN 进行区分。这两种 NaN 之间的差别在 Java 中通常是不可见的。信号 NaN 上的算术运算将它们转换为带有一个有些不同但非常类似的位模式的静默 NaN。但在某些只复制信号 NaN 的处理器上也执行这种转换。特别是在复制信号 NaN，以便将其返回给调用方法的时候，这时可能会执行这种转换。因此，<code>intBitsToFloat</code> 可能无法返回具有信号 NaN 位模式的 <code>float</code> 值。因此，对于某些 <code>int</code> 值，<code>floatToRawIntBits(intBitsToFloat(start))</code> 可能<i>不</i> 等于 <code>start</code>。此外，尽管所有 NaN 位模式，不管是静默 NaN 还是信号 NaN，都必须在上面确定的 NaN 范围内，但表示信号 NaN 的特定位模式是与平台有关的。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bits</CODE> - 一个整数。
<DT><B>返回：</B><DD>具有相同位模式的 <code>float</code> 浮点值。</DL>
</DD>
</DL>
<HR>

<A NAME="compareTo(java.lang.Float)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public int <B>compareTo</B>(<A HREF="Float.html" title="java.lang 中的类">Float</A>&nbsp;anotherFloat)</PRE>
<DL>
<DD>从数字上比较两个 <code>Float</code> 对象。在应用到基本 <code>float</code> 值时，有两种方法来比较执行此方法产生的值与执行 Java 语言的数字比较运算符（<code>&lt;、&lt;=、== 和 &gt;= &gt;</code>）产生的那些值之间的区别：
 <ul><li>
                该方法认为 <code>Float.NaN</code> 将等于其自身，且大于其他所有 <code>float</code> 值（包括 <code>Float.POSITIVE_INFINITY</code>）。
 <li>
                该方法认为 <code>0.0f</code> 将大于 <code>-0.0f</code>。
 </ul>
这可以确保受该方法影响的 <tt>Float</tt> 对象的<i>自然顺序</i> 是<i>与等式一致</i> 的。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Comparable.html" title="java.lang 中的接口">Comparable</A>&lt;<A HREF="Float.html" title="java.lang 中的类">Float</A>&gt;</CODE> 中的 <CODE><A HREF="Comparable.html#compareTo(T)">compareTo</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>anotherFloat</CODE> - 要比较的 <code>Float</code> 值。
<DT><B>返回：</B><DD>如果 <code>anotherFloat</code> 在数字上等于这个 <code>Float</code>，则返回值为 <code>0</code>；如果 <code>anotherFloat</code> 在数字上小于这个 <code>Float</code>，则返回小于 <code>0</code> 的值；如果 <code>anotherFloat</code> 在数字上大于这个 <code>Float</code>，则返回大于 <code>0</code> 的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
<DT><B>另请参见：</B><DD><A HREF="Comparable.html#compareTo(T)"><CODE>Comparable.compareTo(Object)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="compare(float, float)"><!-- --></A><H3>
compare</H3>
<PRE>
public static int <B>compare</B>(float&nbsp;f1,
                          float&nbsp;f2)</PRE>
<DL>
<DD>比较两个指定的 <code>float</code> 值。返回的整数值的符号与通过以下调用返回的整数的符号相同：
 <pre>
   new Float(f1).compareTo(new Float(f2))
 </pre>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f1</CODE> - 要比较的第一个 <code>float</code> 值。<DD><CODE>f1</CODE> - 要比较的第二个 <code>float</code> 值。
<DT><B>返回：</B><DD>如果 <code>f1</code> 在数字上等于这个 <code>f2</code>，则返回值为 <code>0</code>；如果 <code>f1</code> 在数字上小于这个 <code>f2</code>，则返回小于 <code>0</code> 的值；如果 <code>f1</code> 在数字上大于这个 <code>f2</code>，则返回大于 <code>0</code> 的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</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></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Float.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Standard&nbsp;Ed. 5.0</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="ExceptionInInitializerError.html" title="java.lang 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="IllegalAccessError.html" title="java.lang 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html@java_2Flang_2FFloat.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="Float.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<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">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;<A HREF="#field_summary">字段</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;<A HREF="#field_detail">字段</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font>
</BODY>
</HTML>