bitset.html

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

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为指定的值。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;int</CODE></FONT></TD>
<TD><CODE><B><A HREF="BitSet.html#size()">size</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此 <code>BitSet</code> 表示位值时实际使用空间的位数。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;<A HREF="../lang/String.html" title="java.lang 中的类">String</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="BitSet.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回此位 set 的字符串表示形式。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="BitSet.html#xor(java.util.BitSet)">xor</A></B>(<A HREF="BitSet.html" title="java.util 中的类">BitSet</A>&nbsp;set)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;对此位 set 和位 set 参数执行逻辑<b>异或</b>操作。</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TH ALIGN="left"><B>从类 java.lang.<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A> 继承的方法</B></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../lang/Object.html#finalize()">finalize</A>, <A HREF="../lang/Object.html#getClass()">getClass</A>, <A HREF="../lang/Object.html#notify()">notify</A>, <A HREF="../lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../lang/Object.html#wait()">wait</A>, <A HREF="../lang/Object.html#wait(long)">wait</A>, <A HREF="../lang/Object.html#wait(long, int)">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>构造方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="BitSet()"><!-- --></A><H3>
BitSet</H3>
<PRE>
public <B>BitSet</B>()</PRE>
<DL>
<DD>创建一个新的位 set。所有的位初始均为 <code>false</code>。
<P>
</DL>
<HR>

<A NAME="BitSet(int)"><!-- --></A><H3>
BitSet</H3>
<PRE>
public <B>BitSet</B>(int&nbsp;nbits)</PRE>
<DL>
<DD>创建一个位 set，它的初始大小足以显式表示索引范围在 <code>0</code> 到 <code>nbits-1</code> 的位。所有的位初始均为 <code>false</code>。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>nbits</CODE> - 位 set 的初始大小。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/NegativeArraySizeException.html" title="java.lang 中的类">NegativeArraySizeException</A></CODE> - 如果指定的初始大小为负。</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="flip(int)"><!-- --></A><H3>
flip</H3>
<PRE>
public void <B>flip</B>(int&nbsp;bitIndex)</PRE>
<DL>
<DD>将指定索引处的位设置为其当前值的补码。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bitIndex</CODE> - 要翻转位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="flip(int, int)"><!-- --></A><H3>
flip</H3>
<PRE>
public void <B>flip</B>(int&nbsp;fromIndex,
                 int&nbsp;toIndex)</PRE>
<DL>
<DD>将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的每个位设置为其当前值的补码。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 第一个要翻转位的索引。<DD><CODE>toIndex</CODE> - 最后一个要翻转位之后那个位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>fromIndex</tt> 为负，或者 <tt>toIndex</tt> 为负，或者 <tt>fromIndex</tt> 大于 <tt>toIndex</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="set(int)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(int&nbsp;bitIndex)</PRE>
<DL>
<DD>将指定索引处的位设置为 <code>true</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bitIndex</CODE> - 一个位索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="set(int, boolean)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(int&nbsp;bitIndex,
                boolean&nbsp;value)</PRE>
<DL>
<DD>将指定索引处的位设置为指定的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bitIndex</CODE> - 一个位索引。<DD><CODE>value</CODE> - 要设置的 boolean 值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="set(int, int)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(int&nbsp;fromIndex,
                int&nbsp;toIndex)</PRE>
<DL>
<DD>将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为 <code>true</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 第一个要设置位的索引。<DD><CODE>toIndex</CODE> - 最后一个要设置位之后那个位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>fromIndex</tt> 为负，或者 <tt>toIndex</tt> 为负，或者 <tt>fromIndex</tt> 大于 <tt>toIndex</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="set(int, int, boolean)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(int&nbsp;fromIndex,
                int&nbsp;toIndex,
                boolean&nbsp;value)</PRE>
<DL>
<DD>将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为指定的值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 第一个要设置位的索引。<DD><CODE>toIndex</CODE> - 最后一个要设置位之后那个位的索引<DD><CODE>value</CODE> - 所选择的位上要设置的值
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>fromIndex</tt> 为负，或者 <tt>toIndex</tt> 为负，或者 <tt>fromIndex</tt> 大于 <tt>toIndex</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="clear(int)"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>(int&nbsp;bitIndex)</PRE>
<DL>
<DD>将索引指定处的位设置为 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bitIndex</CODE> - 要清除位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。<DT><B>从以下版本开始：</B></DT>
  <DD>JDK1.0</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="clear(int, int)"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>(int&nbsp;fromIndex,
                  int&nbsp;toIndex)</PRE>
<DL>
<DD>将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 第一个要清除位的索引。<DD><CODE>toIndex</CODE> - 最后一个要清除位之后那个位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>fromIndex</tt> 为负，或者 <tt>toIndex</tt> 为负，或者 <tt>fromIndex</tt> 大于 <tt>toIndex</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="clear()"><!-- --></A><H3>
clear</H3>
<PRE>
public void <B>clear</B>()</PRE>
<DL>
<DD>将此 BitSet 中的所有位设置为 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="get(int)"><!-- --></A><H3>
get</H3>
<PRE>
public boolean <B>get</B>(int&nbsp;bitIndex)</PRE>
<DL>
<DD>返回指定索引处的位值。如果当前已设置了此 <code>BitSet</code> 中索引 <code>bitIndex</code> 处的位，则返回 <code>true</code>；否则结果为 <code>false</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>bitIndex</CODE> - 位索引。
<DT><B>返回：</B><DD>指定索引处的位值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。</DL>
</DD>
</DL>
<HR>

<A NAME="get(int, int)"><!-- --></A><H3>
get</H3>
<PRE>
public <A HREF="BitSet.html" title="java.util 中的类">BitSet</A> <B>get</B>(int&nbsp;fromIndex,
                  int&nbsp;toIndex)</PRE>
<DL>
<DD>返回一个新的 <tt>BitSet</tt>，它由此 <tt>BitSet</tt> 中从 <tt>fromIndex</tt>（包括）到 <tt>toIndex</tt>（不包括）范围内的位组成。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 第一个要包括位的索引。<DD><CODE>toIndex</CODE> - 最后一个要包括位之后那个位的索引。
<DT><B>返回：</B><DD>包含此 <tt>BitSet</tt> 某个范围内各位的新 <tt>BitSet</tt>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果 <tt>fromIndex</tt> 为负，或者 <tt>toIndex</tt> 为负，或者 <tt>fromIndex</tt> 大于 <tt>toIndex</tt>。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="nextSetBit(int)"><!-- --></A><H3>
nextSetBit</H3>
<PRE>
public int <B>nextSetBit</B>(int&nbsp;fromIndex)</PRE>
<DL>
<DD>返回第一个设置为 <code>true</code> 的位的索引，这发生在指定的起始索引或之后的索引上。如果没有这样的位，则返回 -1。

要在 <code>BitSet</code> 中的 <code>true</code> 位上进行迭代，可以使用以下循环：

for(int i=bs.nextSetBit(0); i>=0; i=bs.nextSetBit(i+1)) {
     // operate on index i here
 }
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>fromIndex</CODE> - 开始检查的索引（包括）。
<DT><B>返回：</B><DD>下一个已设置为 true 位的索引。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IndexOutOfBoundsException.html" title="java.lang 中的类">IndexOutOfBoundsException</A></CODE> - 如果指定的索引为负。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="nextClearBit(int)"><!-- --></A><H3>
nextClearBit</H3>
<PRE>
public int <B>nextClearBit</B>(int&nbsp;fromIndex)</PRE>
<DL>