integer.html

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

 <dd><i>Sign<sub>opt</sub></i> <code>0</code> <i>OctalDigits</i>
 <p>
 <dt><i>Sign:</i>
 <dd><code>-</code>
 </dl>
 </blockquote>

《<a href="../../../../../../../../java.sun.com/docs/books/jls/html/default.htm">Java Language Specification</a>》的第 <a href="../../../../../../../../java.sun.com/docs/books/jls/second_edition/html/lexical.doc.html#48282">&sect;3.10.1</a> 节中有 <i>DecimalNumeral</i>、<i>HexDigits</i> 和 <i>OctalDigits</i> 的定义。
<p>
跟在（可选）负号和/或基数说明符（&ldquo;<code>0x</code>&rdquo;、&ldquo;<code>0X</code>&rdquo;、&ldquo;<code>#</code>&rdquo;或前导零）后面的字符序列是使用指示的基数（10、16 或 8）通过 <code>Integer.parseInt</code> 方法分析的。字符序列必须表示一个正值，否则会抛出 <A HREF="NumberFormatException.html" title="java.lang 中的类"><CODE>NumberFormatException</CODE></A>。如果指定的 <code>String</code> 的第一个字符是减号，则对结果求反。<code>String</code> 中不允许出现空白字符。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>nm</CODE> - 要解码的 <code>String</code>。
<DT><B>返回：</B><DD>保存有 <code>nm</code> 所表示的 <code>int</code> 值的 <code>Integer</code> 对象。
<DT><B>抛出：</B>
<DD><CODE><A HREF="NumberFormatException.html" title="java.lang 中的类">NumberFormatException</A></CODE> - 如果 <code>String</code> 不包含可分析整数。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
<DT><B>另请参见：</B><DD><A HREF="Integer.html#parseInt(java.lang.String, int)"><CODE>parseInt(java.lang.String, int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="compareTo(java.lang.Integer)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public int <B>compareTo</B>(<A HREF="Integer.html" title="java.lang 中的类">Integer</A>&nbsp;anotherInteger)</PRE>
<DL>
<DD>在数字上比较两个 <code>Integer</code> 对象。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="Comparable.html" title="java.lang 中的接口">Comparable</A>&lt;<A HREF="Integer.html" title="java.lang 中的类">Integer</A>&gt;</CODE> 中的 <CODE><A HREF="Comparable.html#compareTo(T)">compareTo</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>anotherInteger</CODE> - 要比较的 <code>Integer</code>。
<DT><B>返回：</B><DD>如果该 <code>Integer</code> 等于 <code>Integer</code> 参数，则返回 <code>0</code> 值；如果该 <code>Integer</code> 在数字上小于 <code>Integer</code> 参数，则返回小于 <code>0</code> 的值；如果 <code>Integer</code> 在数字上大于 <code>Integer</code> 参数，则返回大于 <code>0</code> 的值（有符号的比较）。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="highestOneBit(int)"><!-- --></A><H3>
highestOneBit</H3>
<PRE>
public static int <B>highestOneBit</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回具有至多单个 1 位的 <tt>int</tt> 值，在指定的 <tt>int</tt> 值中最高位（最左边）的 1 位的位置。如果指定的值在其二进制补码表示形式中不具有 1 位，即它等于零，则返回零。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回具有单个 1 位的 <tt>int</tt> 值, 在指定值中最高位的 1 位的位置，否则，如果指定值本身等于零，则返回零。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="lowestOneBit(int)"><!-- --></A><H3>
lowestOneBit</H3>
<PRE>
public static int <B>lowestOneBit</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回具有至多单个 1 位的 <tt>int</tt> 值，在指定的 <tt>int</tt> 值中最低位（最右边）的 1 位的位置。如果指定的值在其二进制补码表示形式中不具有 1 位，即它等于零，则返回零。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回具有单个 1 位的 <tt>int</tt> 值, 在指定值中最低位的 1 位的位置，否则，如果指定值本身等于零，则返回零。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="numberOfLeadingZeros(int)"><!-- --></A><H3>
numberOfLeadingZeros</H3>
<PRE>
public static int <B>numberOfLeadingZeros</B>(int&nbsp;i)</PRE>
<DL>
<DD>在指定 <tt>int</tt> 值的二进制补码表示形式中最高位（最左边）的 1 位之前，返回零位的数量。如果指定值在其二进制补码表示形式中不存在 1 位，换句话说，如果它等于零，则返回 32。

<p>注意，此方法与基数为 2 的对数密切相关。对于所有的正 <tt>int</tt> 值 x：
 <ul>
 <li>floor(log<sub>2</sub>(x)) = <tt>31 - numberOfLeadingZeros(x)</tt>
 <li>ceil(log<sub>2</sub>(x)) = <tt>32 - numberOfLeadingZeros(x - 1)</tt>
 </ul>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回在指定 <tt>int</tt> 值的二进制补码表示形式中最高位（最左）的 1 位之前的零位的数量；否则，如果该值等于零，则返回 32。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="numberOfTrailingZeros(int)"><!-- --></A><H3>
numberOfTrailingZeros</H3>
<PRE>
public static int <B>numberOfTrailingZeros</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回指定的 <tt>int</tt> 值的二进制补码表示形式中最低（&ldquo;最右&rdquo;）的为 1 的位后面的零位个数。如果指定值在它的二进制补码表示形式中没有为 1 的位，即它的值为零，则返回 32。
<p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回在指定 <tt>int</tt> 值的二进制补码表示形式中最低位（最右）的 1 位之后零位的数量；否则，如果该值等于零，则返回 32。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="bitCount(int)"><!-- --></A><H3>
bitCount</H3>
<PRE>
public static int <B>bitCount</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回指定 <tt>int</tt> 值的二进制补码表示形式的 1 位的数量。此函数有时用于<i>人口普查</i>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回指定 <tt>int</tt> 值的二进制补码表示形式的 1 位的数量。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="rotateLeft(int, int)"><!-- --></A><H3>
rotateLeft</H3>
<PRE>
public static int <B>rotateLeft</B>(int&nbsp;i,
                             int&nbsp;distance)</PRE>
<DL>
<DD>返回根据指定的位数循环左移指定的 <tt>int</tt> 值的二进制补码表示形式而得到的值。（位是从左边（即高位）移出，从右边（即低位）再进入）

<p>注意，使用负距离的左循环等同于右循环：<tt>rotateLeft(val, -distance) == rotateRight(val, distance)</tt>。还要注意的是，以 32 的任何倍数进行的循环都是无操作 (no-op) 指令，因此，即使距离为负，除了最后五位外，其余所有循环距离都可以忽略：<tt>rotateLeft(val, distance) == rotateLeft(val, distance &amp; 0x1F)</tt>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回根据指定的位数循环左移指定的 <tt>int</tt> 值的二进制补码表示形式而得到的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="rotateRight(int, int)"><!-- --></A><H3>
rotateRight</H3>
<PRE>
public static int <B>rotateRight</B>(int&nbsp;i,
                              int&nbsp;distance)</PRE>
<DL>
<DD>返回根据指定的位数循环右移指定的 <tt>int</tt> 值的二进制补码表示形式而得到的值。（位是从右边（即低位）移出，从左边（即高位）再进入）

<p>注意，使用负距离的右循环等同于左循环：<tt>rotateRight(val, -distance) == rotateLeft(val, distance)</tt>。还要注意的是，以 32 的任何倍数进行的循环都是无操作 (no-op) 指令，因此，即使距离为负，除了最后五位外，其余所有循环距离都可以忽略：<tt>rotateRight(val, distance) == rotateRight(val, distance &amp; 0x1F)</tt>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回根据指定的位数循环右移指定的 <tt>int</tt> 值的二进制补码表示形式而得到的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="reverse(int)"><!-- --></A><H3>
reverse</H3>
<PRE>
public static int <B>reverse</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回通过反转指定 <tt>int</tt> 值的二进制补码表示形式中位的顺序而获得的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回通过反转指定 <tt>int</tt> 值中位的顺序而获得的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="signum(int)"><!-- --></A><H3>
signum</H3>
<PRE>
public static int <B>signum</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回指定 <tt>int</tt> 值的符号函数。（如果指定值为负，则返回 －1；如果指定值为零，则返回 0；如果指定的值为正，则返回 1。）
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回指定 <tt>int</tt> 值的符号函数。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="reverseBytes(int)"><!-- --></A><H3>
reverseBytes</H3>
<PRE>
public static int <B>reverseBytes</B>(int&nbsp;i)</PRE>
<DL>
<DD>返回通过反转指定 <tt>int</tt> 值的二进制补码表示形式中字节的顺序而获得的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>返回通过反转指定 <tt>int</tt> 值的字节而获得的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.5</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/Integer.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"