| MuByte.java |
/***************************************
* *
* JBoss: The OpenSource J2EE WebOS *
* *
* Distributable under LGPL license. *
* See terms of license at gnu.org. *
* *
***************************************/
package org.jboss.util;
/**
* A mutable byte class.
*
* @version <tt>$Revision: 1.1 $</tt>
* @author <a href="mailto:jason@planet57.com">Jason Dillon</a>
*/
public class MuByte
extends MuNumber
{
/** Byte value */
private byte value; // = 0;
/**
* Construct a new mutable byte.
*/
public MuByte() {}
/**
* Construct a new mutable byte.
*
* @param b Byte value.
*/
public MuByte(byte b) {
value = b;
}
/**
* Construct a new mutable byte.
*
* @param obj Object to convert to a byte value.
*/
public MuByte(Object obj) {
setValue(obj);
}
/**
* Set the value.
*
* @param b Byte value.
* @return The previous value.
*/
public byte set(byte b) {
byte old = value;
value = b;
return old;
}
/**
* Get the value.
*
* @return Byte value.
*/
public byte get() {
return value;
}
/**
* Set the value to value only if the current value is equal to
* the assumed value.
*
* @param assumed The assumed value.
* @param b The new value.
* @return True if value was changed.
*/
public boolean commit(byte assumed, byte b) {
boolean success = (assumed == value);
if (success) value = b;
return success;
}
/**
* Swap values with another mutable byte.
*
* @param b Mutable byte to swap values with.
* @return The new value.
*/
public byte swap(MuByte b) {
if (b == this) return value;
byte temp = value;
value = b.value;
b.value = temp;
return value;
}
/**
* Increment the value of this mutable byte.
*
* @return Byte value.
*/
public byte increment() {
return ++value;
}
/**
* Decrement the value of this mutable byte.
*
* @return Byte value.
*/
public byte decrement() {
return --value;
}
/**
* Add the specified amount.
*
* @param amount Amount to add.
* @return The new value.
*/
public byte add(byte amount) {
return value += amount;
}
/**
* Subtract the specified amount.
*
* @param amount Amount to subtract.
* @return The new value.
*/
public byte subtract(byte amount) {
return value -= amount;
}
/**
* Multiply by the specified factor.
*
* @param factor Factor to multiply by.
* @return The new value.
*/
public byte multiply(byte factor) {
return value *= factor;
}
/**
* Divide by the specified factor.
*
* @param factor Factor to divide by.
* @return The new value.
*/
public byte divide(byte factor) {
return value /= factor;
}
/**
* Set the value to the negative of its current value.
*
* @return The new value.
*/
public byte negate() {
value = ((byte)-value);
return value;
}
/**
* Set the value to its complement.
*
* @return The new value.
*/
public byte complement() {
value = (byte)~value;
return value;
}
/**
* <i>AND</i>s the current value with the specified value.
*
* @param b Value to <i>and</i> with.
* @return The new value.
*/
public byte and(byte b) {
value = (byte)(value & b);
return value;
}
/**
* <i>OR</i>s the current value with the specified value.
*
* @param b Value to <i>or</i> with.
* @return The new value.
*/
public byte or(byte b) {
value = (byte)(value | b);
return value;
}
/**
* <i>XOR</i>s the current value with the specified value.
*
* @param b Value to <i>xor</i> with.
* @return The new value.
*/
public byte xor(byte b) {
value = (byte)(value ^ b);
return value;
}
/**
* Shift the current value to the <i>right</i>.
*
* @param bits The number of bits to shift.
* @return The new value.
*/
public byte shiftRight(int bits) {
value >>= bits;
return value;
}
/**
* Shift the current value to the <i>right</i> with a zero extension.
*
* @param bits The number of bits to shift.
* @return The new value.
*/
public byte shiftRightZero(int bits) {
value >>>= bits;
return value;
}
/**
* Shift the current value to the <i>left</i>.
*
* @param bits The number of bits to shift.
* @return The new value.
*/
public byte shiftLeft(int bits) {
value <<= bits;
return value;
}
/**
* Compares this object with the specified byte for order.
*
* @param other Value to compare with.
* @return A negative integer, zero, or a positive integer as
* this object is less than, equal to, or greater than
* the specified object.
*/
public int compareTo(byte other) {
return (value < other) ? -1 : (value == other) ? 0 : 1;
}
/**
* Compares this object with the specified object for order.
*
* @param other Value to compare with.
* @return A negative integer, zero, or a positive integer as
* this object is less than, equal to, or greater than
* the specified object.
*
* @throws ClassCastException Object is not a MuByte.
*/
public int compareTo(Object obj) throws ClassCastException {
return compareTo((MuByte)obj);
}
/**
* Convert this mutable byte to a string.
*
* @return String value.
*/
public String toString() {
return String.valueOf(value);
}
/**
* Get the hash code for this mutable byte.
*
* @return Hash code.
*/
public int hashCode() {
return (int)value;
}
/**
* Test the equality of this mutable byte and another object.
*
* @param obj Object to test equality with.
* @return True if object is equal.
*/
public boolean equals(Object obj) {
if (obj == this) return true;
if (obj != null && obj.getClass() == getClass()) {
return value == ((MuByte)obj).byteValue();
}
return false;
}
/**
* Return a cloned copy of this mutable byte.
*
* @return Cloned mutable byte.
*/
public Object clone() {
try {
return super.clone();
}
catch (CloneNotSupportedException e) {
throw new InternalError();
}
}
/////////////////////////////////////////////////////////////////////////
// Number Support //
/////////////////////////////////////////////////////////////////////////
/**
* Return the <code>byte</code> value of this object.
*
* @return <code>byte</code> value.
*/
public byte byteValue() {
return (byte)value;
}
/**
* Return the <code>short</code> value of this object.
*
* @return <code>short</code> value.
*/
public short shortValue() {
return (short)value;
}
/**
* Return the <code>int</code> value of this object.
*
* @return <code>int</code> value.
*/
public int intValue() {
return (int)value;
}
/**
* Return the <code>long</code> value of this object.
*
* @return <code>long</code> value.
*/
public long longValue() {
return (long)value;
}
/**
* Return the <code>float</code> value of this object.
*
* @return <code>float</code> value.
*/
public float floatValue() {
return (float)value;
}
/**
* Return the <code>double</code> value of this object.
*
* @return <code>double</code> value.
*/
public double doubleValue() {
return (double)value;
}
/////////////////////////////////////////////////////////////////////////
// Mutable Support //
/////////////////////////////////////////////////////////////////////////
/**
* Set the value of this mutable byte.
*
* @param obj Object to convert to a <code>byte</code> value.
*/
public void setValue(Object obj) {
if (obj instanceof Number) {
value = ((Number)obj).byteValue();
}
else {
value = (byte)obj.hashCode();
}
}
/**
* Get the byte value of this mutable byte.
*
* @return <code>java.lang.Byte</code> value.
*/
public Object getValue() {
return new Byte(value);
}
}
| MuByte.java |