org.apache.commons.lang
クラス BitField

java.lang.Object
  org.apache.commons.lang.BitField

public class BitField

extends Object

Operations on bit-mapped fields.

導入されたバージョン:

2.0

バージョン:

$Id: BitField.java,v 1.1.1.1 2004/02/13 10:02:05 hioki Exp $

作成者:

Apache Jakarta POI, Scott Sanders (sanders at apache dot org), Marc Johnson (mjohnson at apache dot org), Andrew C. Oliver (acoliver at apache dot org), Stephen Colebourne, Pete Gieser, Gary Gregory

翻訳状況:

訳者募集中

コンストラクタの概要

BitField(int mask)
Creates a BitField instance.

メソッドの概要

int	clear(int holder) Clears the bits.
byte	clearByte(byte holder) Clears the bits.
short	clearShort(short holder) Clears the bits.
int	getRawValue(int holder) Obtains the value for the specified BitField, unshifted.
short	getShortRawValue(short holder) Obtains the value for the specified BitField, unshifted.
short	getShortValue(short holder) Obtains the value for the specified BitField, appropriately shifted right, as a short.
int	getValue(int holder) Obtains the value for the specified BitField, appropriately shifted right.
boolean	isAllSet(int holder) Returns whether all of the bits are set or not.
boolean	isSet(int holder) Returns whether the field is set or not.
int	set(int holder) Sets the bits.
int	setBoolean(int holder, boolean flag) Sets a boolean BitField.
byte	setByte(byte holder) Sets the bits.
byte	setByteBoolean(byte holder, boolean flag) Sets a boolean BitField.
short	setShort(short holder) Sets the bits.
short	setShortBoolean(short holder, boolean flag) Sets a boolean BitField.
short	setShortValue(short holder, short value) Replaces the bits with new values.
int	setValue(int holder, int value) Replaces the bits with new values.

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

BitField

public BitField(int mask)

Creates a BitField instance.

パラメータ:

mask - the mask specifying which bits apply to this BitField. Bits that are set in this mask are the bits that this BitField operates on

メソッドの詳細

getValue

public int getValue(int holder)

Obtains the value for the specified BitField, appropriately shifted right.

Many users of a BitField will want to treat the specified bits as an int value, and will not want to be aware that the value is stored as a BitField (and so shifted left so many bits).

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

the selected bits, shifted right appropriately

関連項目:

setValue(int, int)

getShortValue

public short getShortValue(short holder)

Obtains the value for the specified BitField, appropriately shifted right, as a short.

Many users of a BitField will want to treat the specified bits as an int value, and will not want to be aware that the value is stored as a BitField (and so shifted left so many bits).

パラメータ:

holder - the short data containing the bits we're interested in

戻り値:

the selected bits, shifted right appropriately

関連項目:

setShortValue(short, short)

getRawValue

public int getRawValue(int holder)

Obtains the value for the specified BitField, unshifted.

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

the selected bits

getShortRawValue

public short getShortRawValue(short holder)

Obtains the value for the specified BitField, unshifted.

パラメータ:

holder - the short data containing the bits we're interested in

戻り値:

the selected bits

isSet

public boolean isSet(int holder)

Returns whether the field is set or not.

This is most commonly used for a single-bit field, which is often used to represent a boolean value; the results of using it for a multi-bit field is to determine whether *any* of its bits are set.

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

true if any of the bits are set, else false

isAllSet

public boolean isAllSet(int holder)

Returns whether all of the bits are set or not.

This is a stricter test than isSet(int), in that all of the bits in a multi-bit set must be set for this method to return true.

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

true if all of the bits are set, else false

setValue

public int setValue(int holder,
                    int value)

Replaces the bits with new values.

パラメータ:

holder - the int data containint the bits we're interested in

value - the new value for the specified bits

戻り値:

the value of holder with the bits from the value parameter replacing the old bits

関連項目:

getValue(int)

setShortValue

public short setShortValue(short holder,
                           short value)

Replaces the bits with new values.

パラメータ:

holder - the short data containing the bits we're interested in

value - the new value for the specified bits

戻り値:

the value of holder with the bits from the value parameter replacing the old bits

関連項目:

getShortValue(short)

clear

public int clear(int holder)

Clears the bits.

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

the value of holder with the specified bits cleared (set to 0)

clearShort

public short clearShort(short holder)

Clears the bits.

パラメータ:

holder - the short data containing the bits we're interested in

戻り値:

the value of holder with the specified bits cleared (set to 0)

clearByte

public byte clearByte(byte holder)

Clears the bits.

パラメータ:

holder - the byte data containing the bits we're interested in

戻り値:

the value of holder with the specified bits cleared (set to 0)

set

public int set(int holder)

Sets the bits.

パラメータ:

holder - the int data containing the bits we're interested in

戻り値:

the value of holder with the specified bits set to 1

setShort

public short setShort(short holder)

Sets the bits.

パラメータ:

holder - the short data containing the bits we're interested in

戻り値:

the value of holder with the specified bits set to 1

setByte

public byte setByte(byte holder)

Sets the bits.

パラメータ:

holder - the byte data containing the bits we're interested in

戻り値:

the value of holder with the specified bits set to 1

setBoolean

public int setBoolean(int holder,
                      boolean flag)

Sets a boolean BitField.

パラメータ:

holder - the int data containing the bits we're interested in

flag - indicating whether to set or clear the bits

戻り値:

the value of holder with the specified bits set or cleared

setShortBoolean

public short setShortBoolean(short holder,
                             boolean flag)

Sets a boolean BitField.

パラメータ:

holder - the short data containing the bits we're interested in

flag - indicating whether to set or clear the bits

戻り値:

the value of holder with the specified bits set or cleared

setByteBoolean

public byte setByteBoolean(byte holder,
                           boolean flag)

Sets a boolean BitField.

パラメータ:

holder - the byte data containing the bits we're interested in

flag - indicating whether to set or clear the bits

戻り値:

the value of holder with the specified bits set or cleared