float.html

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

public static <A HREF="String.html" title="java.lang 中的类">String</A> <B>toHexString</B>(float&nbsp;f)</PRE>
<DL>
<DD>返回 <code>float</code> 参数的十六进制字符串表示形式。下面提到的所有字符都是 ASCII 字符。

 <ul>
<li>如果参数为 NaN，则结果是字符串 &quot;<code>NaN</code>&quot;。
<li>否则，结果是表示参数的（代数）符号和大小（绝对值）的字符串。如果符号为负，则结果的第一个字符是 '<code>-</code>' (<code>'\u002D'</code>)；如果符号为正，则结果中不显示符号字符。至于大小值 <i>m</i>：

 <ul> 
<li>如果 <i>m</i> 为无穷大，则用字符串 <code>&quot;Infinity&quot;</code> 表示它；这样，正无穷大产生的结果就是 <code>&quot;Infinity&quot;</code>，而负无穷大产生的结果是 <code>&quot;-Infinity&quot;</code>。

<li>如果 <i>m</i> 为零，则用字符串 <code>&quot;0x0.0p0&quot;</code> 表示它；这样，负零产生的结果就是 <code>&quot;-0x0.0p0&quot;</code>，而正零产生的结果是 <code>&quot;0x0.0p0&quot;</code>。

<li>如果 <i>m</i> 是采用正规表现形式的 <code>float</code> 值，则子字符串被用来表示有效数和指数。有效数是用字符串 <code>&quot;0x1.&quot;</code> 表示的，后面跟着该有效数小数部分的小写的十六进制表示形式。除非所有位数为零，否则移除十六进制表示形式中的尾部零，在所有位数为零的情况下，可以使用一个零表示。其次，指数是用 <code>&quot;p&quot;</code> 表示的，后面跟着无偏指数的十进制字符串，该值与对指数值调用 <A HREF="Integer.html#toString(int)"><CODE>Integer.toString</CODE></A> 所产生的值相同。

<li>如果 <i>m</i> 是采用次正规表现形式的 <code>float</code> 值，则用字符 <code>&quot;0x0.&quot;</code> 表示有效数，后面跟着该有效数小数部分的十六进制表示形式。移除十六进制表示形式中的尾部零。然后用 <code>&quot;p-126&quot;</code> 表示指数。注意，在次正规有效数中，至少必须有一个非零位数。

 </ul>
 
 </ul>

 <table border>
<caption><h3>示例</h3></caption>
<tr><th>浮点值</th><th>十六进制字符串</th>
<tr><td><code>1.0</code></td>   <td><code>0x1.0p0</code></td>
<tr><td><code>-1.0</code></td>  <td><code>-0x1.0p0</code></td>
<tr><td><code>2.0</code></td>   <td><code>0x1.0p1</code></td>
<tr><td><code>3.0</code></td>   <td><code>0x1.8p1</code></td>
<tr><td><code>0.5</code></td>   <td><code>0x1.0p-1</code></td>
<tr><td><code>0.25</code></td>  <td><code>0x1.0p-2</code></td>
<tr><td><code>Float.MAX_VALUE</code></td>
<td><code>0x1.fffffep127</code></td>
<tr><td><code>Minimum Normal Value</code></td>
<td><code>0x1.0p-126</code></td>
<tr><td><code>Maximum Subnormal Value</code></td>
<td><code>0x0.fffffep-126</code></td>
<tr><td><code>Float.MIN_VALUE</code></td>
<td><code>0x0.000002p-126</code></td>
 </table>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f</CODE> - 要转换的 <code>float</code> 值。
<DT><B>返回：</B><DD>参数的十六进制字符串表示形式。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="valueOf(java.lang.String)"><!-- --></A><H3>
valueOf</H3>
<PRE>
public static <A HREF="Float.html" title="java.lang 中的类">Float</A> <B>valueOf</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;s)
                     throws <A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></PRE>
<DL>
<DD>返回保存用参数字符串 <code>s</code> 表示的 <code>float</code> 值的 <code>Float</code> 对象。
 
<p>如果 <code>s</code> 为 <code>null</code>，则抛出 <code>NullPointerException</code> 异常。
 
<p>忽略 <code>s</code> 中的前导空白字符和尾部空白字符。就像调用 <A HREF="String.html#trim()"><CODE>String.trim()</CODE></A> 方法那样移除空白；也就是说，ASCII 空格和控制字符都要移除。<code>s</code> 的其余部分应该按照词法语法规则的描述构成 <i>FloatValue</i>：

<blockquote>
<dl>
<dt><i>FloatValue:</i>
<dd><i>Sign<sub>opt</sub></i> <code>NaN</code>
<dd><i>Sign<sub>opt</sub></i> <code>Infinity</code>
<dd><i>Sign<sub>opt</sub> FloatingPointLiteral</i>
<dd><i>Sign<sub>opt</sub> HexFloatingPointLiteral</i>
<dd><i>SignedInteger</i>
</dl>

<p>

<dl>
<dt><i>HexFloatingPointLiteral</i>:
<dd> <i>HexSignificand BinaryExponent FloatTypeSuffix<sub>opt</sub></i>
</dl>

<p>

<dl>
<dt><i>HexSignificand:</i>
<dd><i>HexNumeral</i>
<dd><i>HexNumeral</i> <code>.</code>
<dd><code>0x</code> <i>HexDigits<sub>opt</sub>
    </i><code>.</code><i>HexDigits</i>
<dd><code>0X</code><i> HexDigits<sub>opt</sub>
    </i><code>.</code><i>HexDigits</i>
</dl>

<p>

<dl>
<dt><i>BinaryExponent:</i>
<dd><i>BinaryExponentIndicator SignedInteger</i>
</dl>

<p>

<dl>
<dt><i>BinaryExponentIndicator:</i>
<dd><code>p</code>
<dd><code>P</code>
</dl>

</blockquote>

其中，<i>Sign</i>、<i>FloatingPointLiteral</i>、<i>HexNumeral</i>、<i>HexDigits</i>、<i>SignedInteger</i> 和 <i>FloatTypeSuffix</i> 与《<a
 href="../../../../../../../../java.sun.com/docs/books/jls/html/default.htm">Java Language Specification</a>》的词法结构部分中的定义相同。如果 <code>s</code> 的表示形式不是 <i>FloatValue</i>，则抛出 <code>NumberFormatException</code> 异常。否则，可以认为 <code>s</code> 表示的是常碰到的&ldquo;计算机科学符号&rdquo;中的精确的十进制值，或者是一个精确的十六进制值；在理论上，这个精确的数值被转换一个&ldquo;无限精确的&rdquo;二进制值，然后根据常用的 IEEE 754 浮点算术的&ldquo;舍入成最接近的数&rdquo;规则对 <code>float</code> 类型的值进行舍入计算，其中包括保留零值的符号。最后，返回表示这个 <code>float</code> 值的 <code>Float</code> 对象。
 
<p>使用 <CODE>NumberFormat</CODE> 的子类来解释浮点值的本地化字符串表示形式。

<p>注意尾部格式说明符，确定浮点文字（<code>1.0f</code> 是一个 <code>float</code> 值；<code>1.0d</code> 是一个 <code>double</code> 值）的类型的说明符<em>不会</em> 影响此方法的结果。换句话说，输入字符串的数值被直接转换为目标浮点类型。通常，转换先后分两步，先将字符串转换为 <code>double</code> 类型，然后将 <code>double</code> 类型转换为 <code>float</code> 类型，这种转换<em>不</em> 同于直接将字符串转换为 <code>float</code> 类型。例如，如果第一步是被转换为中间类型 <code>double</code>，然后再转换为 <code>float</code> 类型，则字符串 <br> <code>&quot;1.00000017881393421514957253748434595763683319091796875001d&quot;</code><br> 被转换为 <code>float</code> 值 <code>1.0000002f</code>；如果直接将字符串转换为 <code>float</code> 值，则产生的结果将是 <code>1.000000<b>1</b>f</code>。

<p>为了避免在无效的字符串上调用此方法并导致抛出 <code>NumberFormatException</code>，<A HREF="Double.html#valueOf(java.lang.String)"><CODE>Double.valueOf</CODE></A> 的文档中列出了一个正则表达式，可以用该表达式在屏幕上显示输入。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>s</CODE> - 要分析的字符串。
<DT><B>返回：</B><DD>保存用 <code>String</code> 参数表示的值的 <code>Float</code> 对象。
<DT><B>抛出：</B>
<DD><CODE><A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></CODE> - 如果字符串不包含可分析的数字。</DL>
</DD>
</DL>
<HR>

<A NAME="valueOf(float)"><!-- --></A><H3>
valueOf</H3>
<PRE>
public static <A HREF="Float.html" title="java.lang 中的类">Float</A> <B>valueOf</B>(float&nbsp;f)</PRE>
<DL>
<DD>返回表示指定的 <tt>float</tt> 值的 <tt>Float</tt> 实例。如果不需要新的 <tt>Float</tt> 实例，则通常应该优先采用此方法，而不是构造方法 <A HREF="Float.html#Float(float)"><CODE>Float(float)</CODE></A>，因为该方法很可能通过缓存经常请求的值来显著提高空间和时间性能。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>f</CODE> - 一个浮点值。
<DT><B>返回：</B><DD>一个表示 <tt>f</tt> 的 <tt>Float</tt> 实例。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="parseFloat(java.lang.String)"><!-- --></A><H3>
parseFloat</H3>
<PRE>
public static float <B>parseFloat</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;s)
                        throws <A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></PRE>
<DL>
<DD>返回一个新的 <code>float</code> 值，该值被初始化为用指定 <code>String</code> 表示的值，这与 <code>Float</code> 类的 <code>valueOf</code> 方法产生的值类似。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>s</CODE> - 要分析的字符串。
<DT><B>返回：</B><DD>用字符串参数表示的 <code>float</code> 值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></CODE> - 如果字符串不包含可分析的 <code>float</code> 值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
<DT><B>另请参见：</B><DD><A HREF="Float.html#valueOf(java.lang.String)"><CODE>valueOf(String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="isNaN(float)"><!-- --></A><H3>
isNaN</H3>
<PRE>
public static boolean <B>isNaN</B>(float&nbsp;v)</PRE>
<DL>
<DD>如果指定的数字是一个非数字值，则返回 <code>true</code>，否则返回 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>v</CODE> - 要测试的值。
<DT><B>返回：</B><DD>如果参数为 NaN，则返回 <code>true</code>；否则返回 <code>false</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="isInfinite(float)"><!-- --></A><H3>
isInfinite</H3>
<PRE>
public static boolean <B>isInfinite</B>(float&nbsp;v)</PRE>
<DL>
<DD>如果指定数字的大小是无穷大，则返回 <code>true</code>，否则返回 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>v</CODE> - 要测试的值。
<DT><B>返回：</B><DD>如果参数是正无穷大或负无穷大，则返回 <code>true</code>；否则返回 <code>false</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="isNaN()"><!-- --></A><H3>
isNaN</H3>
<PRE>
public boolean <B>isNaN</B>()</PRE>
<DL>
<DD>如果这个 <code>Float</code> 值是一个非数字值，则返回 <code>true</code>，否则返回 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果这个对象表示的值是 NaN，则返回 <code>true</code>；否则返回 <code>false</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="isInfinite()"><!-- --></A><H3>
isInfinite</H3>
<PRE>
public boolean <B>isInfinite</B>()</PRE>
<DL>
<DD>如果这个 <code>Float</code> 值的大小是无穷大，则返回 <code>true</code>，否则返回 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果这个对象表示的值是正无穷大或负无穷大，则返回 <code>true</code>；否则返回 <code>false</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD>返回这个 <code>Float</code> 对象的字符串表示形式。使用这个对象表示的基本 <code>float</code> 值被转换为一个 <code>String</code>，该方法与带有一参数的 <code>toString</code> 方法非常类似。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="Object.html#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>这个对象的 <code>String</code> 表示。<DT><B>另请参见：</B><DD><A HREF="Float.html#toString(float)"><CODE>toString(float)</CODE></A></DL>
</DD>
</DL>
<HR>

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

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

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

<DT><B>返回：</B><DD>这个对象所表示的 <code>float</code> 值，该值被转换为 <code>short</code> 类型<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.1</DD>
</DL>
</DD>
</DL>
<HR>

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