jcgp.backend.function

Class UnsignedInteger

java.lang.Object

jcgp.backend.function.UnsignedInteger

public class UnsignedInteger
extends java.lang.Object

Integer wrapper type for unsigned integer values.

Java offers no support for unsigned types save from unsigned conversion methods. This class uses those methods to simulate the unsigned int data type, useful for circuit truth table encodings.

When a string representation of an unsigned integer is parsed using Integer.parseUnsignedInt(), an Integer is created using all 32 bits for unsigned magnitude. The integer however is still signed and will behave as such for all arithmetic operations. Bitwise operations can still be performed as they work at the bit level, making this data type particularly suitable for circuit design.

TODO in the unlikely event that unsigned integers are natively implemented in Java, they should be used instead of this class.

Why are unsigned integers not supported?
http://stackoverflow.com/questions/430346/why-doesnt-java-support-unsigned-ints

Author:

Eduardo Pedroni

See Also:

Integer

Constructor Summary

Constructors

Constructor and Description
UnsignedInteger(int i) Makes a new instance of UnsignedInteger with a specified value.
UnsignedInteger(java.lang.Integer i) Makes a new instance of UnsignedInteger with a specified value.
UnsignedInteger(java.lang.String i) Makes a new instance of UnsignedInteger from the string representation of an unsigned integer.

Method Summary

Modifier and Type	Method and Description
java.lang.Integer	get()
java.lang.String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

UnsignedInteger

public UnsignedInteger(int i)

Makes a new instance of UnsignedInteger with a specified value.

Parameters:

i - the value with which to initialise.

UnsignedInteger

public UnsignedInteger(java.lang.Integer i)

Makes a new instance of UnsignedInteger with a specified value.

Parameters:

i - the value with which to initialise.

UnsignedInteger

public UnsignedInteger(java.lang.String i)

Makes a new instance of UnsignedInteger from the string representation of an unsigned integer.

Parameters:

i - the string with which to initialise.

Method Detail

get

public java.lang.Integer get()

Returns:

the wrapped Integer object.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object