* * This implements the SerializationInterface, which means it can be * written out to a stream in the standard DIS 32-bit format.
* * See comments in UnsignedByte for description of how the mapping between * negative values and unsigned positive values works.
* * This implements the Cloneable interface, which means that when we clone() * something we can do a bitwise field copy (shallow copy). This needs to * change if we ever have any actual objects contained in this class.
* *
*
UnsignedInt object and intializes its value to 0.
*/
public UnsignedInt()
{ _data = 0;
}
/**
*Constructs an UnsignedInt object from a signed int,
*throws an exception if the parameter is out of range.
*
*@param pData >=0
*@exception RuntimeException if pData is out of range
*/
public UnsignedInt(int pData)
{
if(pData < 0)
throw new
RuntimeException("Exception in UnsignedInt. Attempt to assign value beyond maximum range of an unsigned int.");
_data = pData;
}
/**
*Constructs a UnsignedInt object from a signed short,
*throws an exception if the paraneter is out of range.
*
*@param pData >=0
*@exception RuntimeException if pData is out of range
*/
public UnsignedInt(short pData)
{
if( pData < 0)
throw new
RuntimeException("Exception in UnsignedInt. Attempt to assign value beyond maximum range of an unsigned int.");
_data = pData;
}
/**
*Constructs a UnsignedInt object from a signed long,
*throws an exception if the parameter is out of range.
*
*@param pData >=0,<=MAX_INT_VALUE
*@exception RuntimeException if pData is out of range
*/
public UnsignedInt(long pData)
{
if((pData > MAX_INT_VALUE) || ( pData < 0))
throw new
RuntimeException("Exception in UnsignedInt. Attempt to assign value beyond maximum range of an unsigned int.");
_data = (int)pData;
}
/**
*Returns the current value of this object as a double float,
*after conversion.
*
*@return the current value of this object as a double float
*/
public double doubleValue()
{
double temp;
temp = (_data < 0 ? MAX_INT_VALUE + _data + 1 : _data);
return temp;
}
/**
*Returns a the current value of this object as a float, after conversion.
*
*@return the current value of this object as a float
*/
public float floatValue()
{
float temp;
temp = (_data < 0 ? MAX_INT_VALUE + _data + 1 : _data);
return temp;
}
/**
*Returns the current value of this object as a long, after conversion.
*
*@return the current value of this object as a long
*/
public long longValue()
{
long temp;
temp = (_data < 0 ? MAX_INT_VALUE + _data + 1 : _data);
return temp;
}
/**
*Don't use this !
*
*IOException occurs.
*
*@see SerializationInterface
*/
public void serialize(DataOutputStream pOutputStream)
{
try
{
pOutputStream.writeInt(_data);
}
catch (IOException ioError)
{
throw new
RuntimeException("Exception in UnsignedInt. Error writing to file.");
}
}
/**
*Reads a UnsignedInt in from DIS format.
*
*@param inputstream the input stream that builds the object.
*@exception RuntimeException if an IOException occurs.
*
*@see SerializationInterface
*/
public void deSerialize(DataInputStream pInputStream)
{
try
{
_data = pInputStream.readInt();
}
catch (IOException ioError)
{
throw new
RuntimeException("Exception in UnsignedInt. Error reading from file.");
}
}
/**
*Returns a String object representing this UnsignedInt value.
*
*@return a string representation of the value of this object in base 10.
*/
public String toString()
{
Long temp = new Long(this.longValue());
return temp.toString();
}
/**
*Makes a deep copy of the current UnsignedInt object.
*
*@return the cloned object.
*@exception RuntimeException if cloning fails
*/
public Object clone()
{
Object newObject;
try{
newObject = super.clone(); // shallow copy
}
catch(CloneNotSupportedException cloneError)
{
throw new
RuntimeException("Exception in UnsignedByte. Error cloning object.");
}
return newObject;
}
/**
*Of debugging interest only. You shouldn't have to use this method.
*/
public void debugTest()
{
// Some testing to make sure things work right.
UnsignedInt zero, one, two, three, four;
// test extreme values for bytes; zero, near the roll-over point, and the max value
System.out.println("Testing functionality of unsigned int class");
zero = new UnsignedInt((long)0);
one = new UnsignedInt((long)2147483647 );
two = new UnsignedInt((long)2147483648L);
three = new UnsignedInt((long)2147483649L );
four = new UnsignedInt((long)MAX_INT_VALUE);
System.out.println("Values should be 0, 2147483647, 2147483648L, 2147483649L, 4294907295L:" + zero.toString() + " " + one.toString()
+ " " + two.toString() + " " + three.toString() + " " + four.toString());
// Causes runtime exception
//zero = new UnsignedInt(-1);
//one = new UnsignedInt((long) MAX_INT_VALUE + 1);
};
} // end of class UnsignedInt