Package com.pnfsoftware.jeb.util.primitives

Class LargeIntHandler

java.lang.Object

com.pnfsoftware.jeb.util.primitives.LargeIntHandler

public class LargeIntHandler
extends Object

Handler for large integers of a given maximum bitsize. Those objects are created through a factory method.

Method Summary

Modifier and Type	Method	Description
BigInteger	add(BigInteger a, BigInteger b)
BigInteger	and(BigInteger a, BigInteger b)
BigInteger	clearbit(BigInteger a, int n)
int	compare(BigInteger a, BigInteger b)
int	compareU(BigInteger a, BigInteger b)
static LargeIntHandler	create(int bitsize)
BigInteger	create(String val)	Create a new big integer.
BigInteger[]	div2S(BigInteger a, BigInteger b)
BigInteger[]	div2U(BigInteger a, BigInteger b)
BigInteger	divS(BigInteger a, BigInteger b)
BigInteger	divU(BigInteger a, BigInteger b)
int	getBitsize()
BigInteger	mul2S(BigInteger a, BigInteger b)
BigInteger	mul2U(BigInteger a, BigInteger b)
BigInteger	mulS(BigInteger a, BigInteger b)
BigInteger	mulU(BigInteger a, BigInteger b)
BigInteger	neg(BigInteger a)
BigInteger	not(BigInteger a)
BigInteger	or(BigInteger a, BigInteger b)
BigInteger	remS(BigInteger a, BigInteger b)
BigInteger	remU(BigInteger a, BigInteger b)
BigInteger	rol(BigInteger a, int n)
BigInteger	ror(BigInteger a, int n)
BigInteger	sar(BigInteger a, int n)	shift with modulo-count (positive)
BigInteger	setbit(BigInteger a, int n)
BigInteger	shl(BigInteger a, int n)	shift with modulo-count (positive)
BigInteger	shr(BigInteger a, int n)	shift with modulo-count (positive)
BigInteger	sub(BigInteger a, BigInteger b)
boolean	testbit(BigInteger a, int n)
BigInteger	toUnsigned(BigInteger a)	Get the unsigned equivalent of the provided truncated integer.
String	toUnsignedHexString(BigInteger v)
BigInteger	truncate(String val)	Truncate and store as a signed value.
BigInteger	truncate(BigInteger v)	Truncate and store as a signed value.
BigInteger	xor(BigInteger a, BigInteger b)

Methods inherited from class java.lang.Object

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

Method Details

create

public static LargeIntHandler create(int bitsize)

getBitsize

public int getBitsize()

create

public BigInteger create(String val)

Create a new big integer. The client is responsible for making sure that the two-complement representation of the value fits within bitsize bits.

Parameters:

val -

Returns:

truncate

public BigInteger truncate(String val)

Truncate and store as a signed value. The resulting integer 2-complement representation holds on at most bitsize bits.

Parameters:

val - string value (decimal, hex, or octal - with the right associated prefix or suffix)

Returns:

truncate

public BigInteger truncate(BigInteger v)

Truncate and store as a signed value. The resulting integer 2-complement representation holds on at most bitsize bits.

Parameters:

v -

Returns:

toUnsigned

public BigInteger toUnsigned(BigInteger a)

Get the unsigned equivalent of the provided truncated integer.

Warning, this method is unsafe! The result may no longer be representable on bitsize bits.

Parameters:

a -

Returns:

neg

public BigInteger neg(BigInteger a)

add

public BigInteger add(BigInteger a,
 BigInteger b)

sub

public BigInteger sub(BigInteger a,
 BigInteger b)

mulS

public BigInteger mulS(BigInteger a,
 BigInteger b)

mulU

public BigInteger mulU(BigInteger a,
 BigInteger b)

mul2S

public BigInteger mul2S(BigInteger a,
 BigInteger b)

mul2U

public BigInteger mul2U(BigInteger a,
 BigInteger b)

divS

public BigInteger divS(BigInteger a,
 BigInteger b)

divU

public BigInteger divU(BigInteger a,
 BigInteger b)

remS

public BigInteger remS(BigInteger a,
 BigInteger b)

remU

public BigInteger remU(BigInteger a,
 BigInteger b)

div2S

public BigInteger[] div2S(BigInteger a,
 BigInteger b)

div2U

public BigInteger[] div2U(BigInteger a,
 BigInteger b)

and

public BigInteger and(BigInteger a,
 BigInteger b)

or

public BigInteger or(BigInteger a,
 BigInteger b)

not

public BigInteger not(BigInteger a)

xor

public BigInteger xor(BigInteger a,
 BigInteger b)

testbit

public boolean testbit(BigInteger a,
 int n)

setbit

public BigInteger setbit(BigInteger a,
 int n)

clearbit

public BigInteger clearbit(BigInteger a,
 int n)

shl

public BigInteger shl(BigInteger a,
 int n)

shift with modulo-count (positive)

shr

public BigInteger shr(BigInteger a,
 int n)

shift with modulo-count (positive)

sar

public BigInteger sar(BigInteger a,
 int n)

shift with modulo-count (positive)

ror

public BigInteger ror(BigInteger a,
 int n)

rol

public BigInteger rol(BigInteger a,
 int n)

compare

public int compare(BigInteger a,
 BigInteger b)

compareU

public int compareU(BigInteger a,
 BigInteger b)

toUnsignedHexString

public String toUnsignedHexString(BigInteger v)