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 |