Java java.util 类 BitSet（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.util
类 BitSet

java.lang.Object
  java.util.BitSet

所有已实现的接口：

Serializable, Cloneable

---

public class BitSet
   
   
   
   
   
extends Object
   
   
   
   
   
   
   
   
   
   
implements Cloneable, Serializable
   
   
   
   
   

此类实现了一个按需增长的位向量。位 set 的每个组件都有一个 boolean 值。用非负的整数将 BitSet 的位编入索引。可以对每个编入索引的位进行测试、设置或者清除。通过逻辑与、逻辑或和逻辑异或操作，可以使用一个 BitSet 修改另一个 BitSet 的内容。

默认情况下，set 中所有位的初始值都是 false。

每个位 set 都有一个当前大小，也就是该位 set 当前所用空间的位数。注意，这个大小与位 set 的实现有关，所以它可能随实现的不同而更改。位 set 的长度与位 set 的逻辑长度有关，并且是与实现无关而定义的。

除非另行说明，否则将 null 参数传递给 BitSet 中的任何方法都将导致 NullPointerException。 在没有外部同步的情况下，多个线程操作一个 BitSet 是不安全的。

从以下版本开始：

JDK1.0

另请参见：

序列化表格

---

构造方法摘要
BitSet()           创建一个新的位 set。
BitSet(int nbits)           创建一个位 set，它的初始大小足以显式表示索引范围在 0 到 nbits-1 的位。

 

方法摘要
void	and(BitSet set)           对此目标位 set 和参数位 set 执行逻辑与操作。
void	andNot(BitSet set)           清除此 BitSet 中所有的位，其相应的位在指定的 BitSet 中已设置。
int	cardinality()           返回此 BitSet 中设置为 true 的位数。
void	clear()           将此 BitSet 中的所有位设置为 false。
void	clear(int bitIndex)           将索引指定处的位设置为 false。
void	clear(int fromIndex, int toIndex)           将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为 false。
Object	clone()           克隆此 BitSet，生成一个与之相等的新 BitSet。
boolean	equals(Object obj)           将此对象与指定的对象进行比较。
void	flip(int bitIndex)           将指定索引处的位设置为其当前值的补码。
void	flip(int fromIndex, int toIndex)           将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的每个位设置为其当前值的补码。
boolean	get(int bitIndex)           返回指定索引处的位值。
BitSet	get(int fromIndex, int toIndex)           返回一个新的 BitSet，它由此 BitSet 中从 fromIndex（包括）到 toIndex（不包括）范围内的位组成。
int	hashCode()           返回此位 set 的哈希码值。
boolean	intersects(BitSet set)           如果指定的 BitSet 中有设置为 true 的位，并且在此 BitSet 中也将其设置为 true，则返回 ture。
boolean	isEmpty()           如果此 BitSet 中没有包含任何设置为 true 的位，则返回 ture。
int	length()           返回此 BitSet 的“逻辑大小”：BitSet 中最高设置位的索引加 1。
int	nextClearBit(int fromIndex)           返回第一个设置为 false 的位的索引，这发生在指定的起始索引或之后的索引上。
int	nextSetBit(int fromIndex)           返回第一个设置为 true 的位的索引，这发生在指定的起始索引或之后的索引上。
void	or(BitSet set)           对此位 set 和位 set 参数执行逻辑或操作。
void	set(int bitIndex)           将指定索引处的位设置为 true。
void	set(int bitIndex, boolean value)           将指定索引处的位设置为指定的值。
void	set(int fromIndex, int toIndex)           将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为 true。
void	set(int fromIndex, int toIndex, boolean value)           将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为指定的值。
int	size()           返回此 BitSet 表示位值时实际使用空间的位数。
String	toString()           返回此位 set 的字符串表示形式。
void	xor(BitSet set)           对此位 set 和位 set 参数执行逻辑异或操作。

 

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait

 

构造方法详细信息

BitSet

public BitSet()

创建一个新的位 set。所有的位初始均为 false。

---

BitSet

public BitSet(int nbits)

创建一个位 set，它的初始大小足以显式表示索引范围在 0 到 nbits-1 的位。所有的位初始均为 false。

参数：

nbits - 位 set 的初始大小。

抛出：

NegativeArraySizeException - 如果指定的初始大小为负。

方法详细信息

flip

public void flip(int bitIndex)

将指定索引处的位设置为其当前值的补码。

参数：

bitIndex - 要翻转位的索引。

抛出：

IndexOutOfBoundsException - 如果指定的索引为负。

从以下版本开始：

1.4

---

flip

public void flip(int fromIndex,
                 int toIndex)

将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的每个位设置为其当前值的补码。

参数：

fromIndex - 第一个要翻转位的索引。

toIndex - 最后一个要翻转位之后那个位的索引。

抛出：

IndexOutOfBoundsException - 如果 fromIndex 为负，或者 toIndex 为负，或者 fromIndex 大于 toIndex。

从以下版本开始：

1.4

---

set

public void set(int bitIndex)

将指定索引处的位设置为 true。

参数：

bitIndex - 一个位索引。

抛出：

IndexOutOfBoundsException - 如果指定的索引为负。

从以下版本开始：

JDK1.0

---

set

public void set(int bitIndex,
                boolean value)

将指定索引处的位设置为指定的值。

参数：

bitIndex - 一个位索引。

value - 要设置的 boolean 值。

抛出：

IndexOutOfBoundsException - 如果指定的索引为负。

从以下版本开始：

1.4

---

set

public void set(int fromIndex,
                int toIndex)

将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为 true。

参数：

fromIndex - 第一个要设置位的索引。

toIndex - 最后一个要设置位之后那个位的索引。

抛出：

IndexOutOfBoundsException - 如果 fromIndex 为负，或者 toIndex 为负，或者 fromIndex 大于 toIndex。

从以下版本开始：

1.4

---

set

public void set(int fromIndex,
                int toIndex,
                boolean value)

将指定的 fromIndex（包括）到指定的 toIndex（不包括）范围内的位设置为指定的值。

参数：

fromIndex - 第一个要设置位的索引。

toIndex - 最后一个要设置位之后那个位的索引

value - 所选择的位上要设置的值

抛出：

IndexOutOfBoundsException - 如果 fromIndex 为负，或者 toIndex 为负，或者 fromIndex 大于 toIndex。

从以下版本开始：

1.4