integer.html

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

<HR>

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

<A NAME="byteValue()"><!-- --></A><H3>
byteValue</H3>
<PRE>
public byte <B>byteValue</B>()</PRE>
<DL>
<DD>以 <code>byte</code> 类型返回该 <code>Integer</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>byte</code> 类型后该对象表示的数值。</DL>
</DD>
</DL>
<HR>

<A NAME="shortValue()"><!-- --></A><H3>
shortValue</H3>
<PRE>
public short <B>shortValue</B>()</PRE>
<DL>
<DD>以 <code>short</code> 类型返回该 <code>Integer</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>short</code> 类型后该对象表示的数值。</DL>
</DD>
</DL>
<HR>

<A NAME="intValue()"><!-- --></A><H3>
intValue</H3>
<PRE>
public int <B>intValue</B>()</PRE>
<DL>
<DD>以 <code>int</code> 类型返回该 <code>Integer</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>
<DD><DL>

<DT><B>返回：</B><DD>转换为 <code>int</code> 类型后该对象表示的数值。</DL>
</DD>
</DL>
<HR>

<A NAME="longValue()"><!-- --></A><H3>
longValue</H3>
<PRE>
public long <B>longValue</B>()</PRE>
<DL>
<DD>以 <code>long</code> 类型返回该 <code>Integer</code> 的值。
<p>
<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>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>Integer</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>double</code> 类型返回该 <code>Integer</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>double</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>Integer</code> 值的 <code>String</code> 对象。将该参数转换为有符号的十进制表示形式，并以字符串的形式返回它，就好像将该整数值作为参数赋予 <A HREF="Integer.html#toString(int)"><CODE>toString(int)</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#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>该对象的值（基数 10）的字符串表示形式。</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回此 <code>Integer</code> 的哈希代码。
<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>该对象的哈希代码值，它等于用这个 <code>Integer</code> 对象表示的基本的 <code>int</code> 值。<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>int</code> 值的 <code>Integer</code> 对象时，结果为 <code>true</code>。
<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="Object.html#hashCode()"><CODE>Object.hashCode()</CODE></A>, 
<A HREF="../util/Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getInteger(java.lang.String)"><!-- --></A><H3>
getInteger</H3>
<PRE>
public static <A HREF="Integer.html" title="java.lang 中的类">Integer</A> <B>getInteger</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;nm)</PRE>
<DL>
<DD>确定具有指定名称的系统属性的整数值。
 <p>
第一个参数被视为系统属性的名称。通过 <A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A> 方法可以访问系统属性。然后，将该属性的字符串值解释为一个整数值，并返回表示该值的 <code>Integer</code> 对象。使用 <code>getProperty</code> 的定义可以找到可能出现的数字格式的详细信息。 
 <p>
如果没有具有指定名称的属性，或者指定名称为空或 <code>null</code>，或者属性的数字格式不正确，则返回 <code>null</code>。
 <p>
 换句话说，该方法返回一个等于以下值的 <code>Integer</code> 对象：

<blockquote><code>getInteger(nm, null)</code></blockquote>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>nm</CODE> - 属性名。
<DT><B>返回：</B><DD>属性的 <code>Integer</code> 值。<DT><B>另请参见：</B><DD><A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A>, 
<A HREF="System.html#getProperty(java.lang.String, java.lang.String)"><CODE>System.getProperty(java.lang.String, java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getInteger(java.lang.String, int)"><!-- --></A><H3>
getInteger</H3>
<PRE>
public static <A HREF="Integer.html" title="java.lang 中的类">Integer</A> <B>getInteger</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;nm,
                                 int&nbsp;val)</PRE>
<DL>
<DD>确定具有指定名称的系统属性的整数值。
 <p>
第一个参数被视为系统属性的名称。通过 <A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A> 方法可以访问系统属性。然后，将该属性的字符串值解释为一个整数值，并返回表示该值的 <code>Integer</code> 对象。使用 <code>getProperty</code> 的定义可以找到可能出现的数字格式的详细信息。 
 <p>
第二个参数是默认值。如果未具有指定名称的属性，或者属性的数字格式不正确，或者指定名称为空或 <code>null</code>，则返回一个表示第二个参数的值的 <code>Integer</code> 对象。
 <p>
 换句话说，该方法返回一个等于以下值的 <code>Integer</code> 对象：
 <blockquote><code>getInteger(nm, new Integer(val))</code></blockquote>
但在实践中可能会用以下类似方式实现它：
 <blockquote><pre>
 Integer result = getInteger(nm, null);
 return (result == null) ? new Integer(val) : result;
 </pre></blockquote>
从而避免在无需默认值时分配不必要的 <code>Integer</code> 对象。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>nm</CODE> - 属性名。<DD><CODE>val</CODE> - 默认值。
<DT><B>返回：</B><DD>属性的 <code>Integer</code> 值。<DT><B>另请参见：</B><DD><A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A>, 
<A HREF="System.html#getProperty(java.lang.String, java.lang.String)"><CODE>System.getProperty(java.lang.String, java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getInteger(java.lang.String, java.lang.Integer)"><!-- --></A><H3>
getInteger</H3>
<PRE>
public static <A HREF="Integer.html" title="java.lang 中的类">Integer</A> <B>getInteger</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;nm,
                                 <A HREF="Integer.html" title="java.lang 中的类">Integer</A>&nbsp;val)</PRE>
<DL>
<DD>返回具有指定名称的系统属性的整数值。第一个参数被视为系统属性的名称。通过 <A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A> 方法可以访问系统属性。然后，根据每个 <code>Integer.decode</code> 方法，将该属性的字符串值解释为一个整数值，并返回一个表示该值的 <code>Integer</code> 对象。
 <p>
<ul><li>如果属性值以两个 ASCII 字符 <code>0x</code> 或者 ASCII 字符 <code>#</code> 开始，并且后面没有减号，则将它的剩余部分分析为十六进制整数，就好像以 16 为基数调用 <A HREF="Integer.html#valueOf(java.lang.String, int)"><CODE>valueOf(java.lang.String, int)</CODE></A> 方法一样。
<li>如果属性值以 ASCII 字符 <code>0</code> 开始，后面还有其他字符，则将它分析为八进制整数，就好像以 8 为基数调用 <A HREF="Integer.html#valueOf(java.lang.String, int)"><CODE>valueOf(java.lang.String, int)</CODE></A> 方法一样。
<li>否则，将属性值分析为十进制整数，就好像以 10 为基数调用 <A HREF="Integer.html#valueOf(java.lang.String, int)"><CODE>valueOf(java.lang.String, int)</CODE></A> 方法一样。
 </ul><p>
第二个参数是默认值。如果未具有指定名称的属性，或者属性的数字格式不正确，或者指定名称为空或 <code>null</code>，则返回默认值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>nm</CODE> - 属性名。<DD><CODE>val</CODE> - 默认值。
<DT><B>返回：</B><DD>属性的 <code>Integer</code> 值。<DT><B>另请参见：</B><DD><A HREF="System.html#getProperty(java.lang.String)"><CODE>System.getProperty(java.lang.String)</CODE></A>, 
<A HREF="System.html#getProperty(java.lang.String, java.lang.String)"><CODE>System.getProperty(java.lang.String, java.lang.String)</CODE></A>, 
<A HREF="Integer.html#decode(java.lang.String)"><CODE>decode(java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="decode(java.lang.String)"><!-- --></A><H3>
decode</H3>
<PRE>
public static <A HREF="Integer.html" title="java.lang 中的类">Integer</A> <B>decode</B>(<A HREF="String.html" title="java.lang 中的类">String</A>&nbsp;nm)
                      throws <A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></PRE>
<DL>
<DD>将 <code>String</code> 解码为 <code>Integer</code>。接受通过以下语法给出的十进制、十六进制和八进制数字：

 <blockquote>
 <dl>
 <dt><i>DecodableString:</i>
 <dd><i>Sign<sub>opt</sub> DecimalNumeral</i>
 <dd><i>Sign<sub>opt</sub></i> <code>0x</code> <i>HexDigits</i>
 <dd><i>Sign<sub>opt</sub></i> <code>0X</code> <i>HexDigits</i>
 <dd><i>Sign<sub>opt</sub></i> <code>#</code> <i>HexDigits</i>