java.lang.Object
   |
   +--java.lang.Number
         |
         +--java.math.BigInteger

Deklaration

Beschreibung

Datenelemente
public final static BigInteger	ZERO
public final static BigInteger	ONE

Methoden
public BigInteger	abs()
public BigInteger	add(BigInteger val)
public BigInteger	and(BigInteger val)
public BigInteger	andNot(BigInteger val)
public int	bitCount()
public int	bitLength()
public BigInteger	clearBit(int n)
public int	compareTo(BigInteger val)
public int	compareTo(Object o)
public BigInteger	divide(BigInteger val)
public BigInteger[]	divideAndRemainder(BigInteger val)
public double	doubleValue()
public boolean	equals(Object x)
public BigInteger	flipBit(int n)
public float	floatValue()
public BigInteger	gcd(BigInteger val)
public int	getLowestSetBit()
public int	hashCode()
public int	intValue()
public boolean	isProbablePrime(int certainty)
public long	longValue()
public BigInteger	max(BigInteger val)
public BigInteger	min(BigInteger val)
public BigInteger	mod(BigInteger m)
public BigInteger	modInverse(BigInteger m)
public BigInteger	modPow(BigInteger exponent, BigInteger m)
public BigInteger	multiply(BigInteger val)
public BigInteger	negate()
public BigInteger	not()
public BigInteger	or(BigInteger val)
public BigInteger	pow(int exponent)
public static BigInteger	probablePrime(int bitLength, Random rnd)
public BigInteger	remainder(BigInteger val)
public BigInteger	setBit(int n)
public BigInteger	shiftLeft(int n)
public BigInteger	shiftRight(int n)
public int	signum()
public BigInteger	subtract(BigInteger val)
public boolean	testBit(int n)
public byte[]	toByteArray()
public String	toString()
public String	toString(int radix)
public static BigInteger	valueOf(long val)
public BigInteger	xor(BigInteger val)

Datenelemente im Detail

public final static BigInteger ZERO     

Vordefiniertes Objekt mit dem Wert Null.

public final static BigInteger ONE     

Vordefinierte Objekt mit dem Wert Eins.

Konstruktoren im Detail

public BigInteger(byte[] val)

Erzeugt ein neues BigInteger-Objekt aus dem byte-Array val. val muß die Zweier-Komplementdarstellung der Zahl enthalten, wobei davon ausgegangen wird, daß das höchstwertige Byte an Indexposition null steht. Das höchstwertige Bit dieses Bytes legt das Vorzeichen fest.

Exception: NumberFormatException

• Falls ein leeres Array übergeben wird.

public BigInteger(String val)

Erzeugt ein neues BigInteger-Objekt aus dem String-Objekt val, wobei das Dezimalsystem zugrunde gelegt wird.

Exception: NumberFormatException

• Falls in val ein Zeichen vorkommt, das kein Vorzeichen oder eine Ziffer ist.

public BigInteger(String val, int radix)

Erzeugt ein neues BigInteger-Objekt aus dem String-Objekt val, wobei das durch radix angegebene Zahlensystem zugrunde gelegt wird.

Exception: NumberFormatException

• Falls in val ein Zeichen vorkommt, das kein Vorzeichen oder eine Ziffer des angegebenen Zahlensystems ist.

public BigInteger(int signum, byte[] magnitude)

Erzeugt ein neues BigInteger-Objekt mit dem durch signum festgelegten Vorzeichen (1 positiv, 0 null, -1 negativ) und dem in magnitude enthaltenen Wert. Die Bytes müssen mit fallender Wertigkeit angeordnet sein.

Exception: NumberFormatException

• Falls signum einen anderen Wert als 1, 0 null oder -1 hat.
• Wenn signum null ist und magnitude nicht leer ist.

public BigInteger(int numBits, Random rndSrc)

Erzeugt ein neues BigInteger-Objekt, das mit einer Zufallszahl initialisiert wird. Die Zufallszahl hat numBits Bits. Die erforderlichen Zufallszahlen werden von rndSrc abgerufen.

Exception: IllegalArgumentException

• Falls numBits kleiner als null ist.

public BigInteger(int bitLength, int certainty, Random rnd)

Erzeugt ein neues BigInteger-Objekt, das mit einer Zufallszahl initialisiert wird. Die Zufallszahl hat bitLength Bits und ist mit einer Wahrscheinlichkeit von 1-1/2 hoch certainty prim. Die erforderlichen Zufallszahlen werden von rnd abgerufen.

Exception: ArithmeticException

• Falls bitLength kleiner als zwei ist.

Methoden im Detail

public BigInteger abs()

Liefert den Betrag zurück.

public BigInteger add(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die Summe von diesem Objekt und von val enthält.

Exception: ArithmeticException

public BigInteger and(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die bitweise Und-Verknüpfung von val mit diesem Objekt enthält.

public BigInteger andNot(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die bitweise Und-Verknüpfung der bitweisen Negation von val mit diesem Objekt enthält.

public int bitCount()

Liefert die Anzahl der Bits der Zweier-Komplementdarstellung des Werts. die vom Vorzeichenbit verschieden sind.

public int bitLength()

Liefert die Anzahl der Bits der Zweier-Komplementdarstellung des Werts, wobei das Vorzeichenbit nicht mitgezählt wird.

public BigInteger clearBit(int n)

Löscht das Bit an der Position n.

Exception: ArithmeticException

• Falls n kleiner als null ist.

public int compareTo(BigInteger val)     

Vergleicht den Wert dieses Objekts mit dem von val. Der Rückgabewert ist null, wenn die Werte gleich sind. Er ist kleiner als null, wenn der Wert dieses Objekts kleiner als der von val ist. Der Rückgabewert ist größer als null, wenn der Wert dieses Objekts größer als val ist.

public int compareTo(Object o)     

Vergleicht den Wert dieses Objekts mit dem des Parameters o, für den ein BigInteger-Exemplar übergeben werden muss. Der Rückgabewert ist null, wenn die Werte gleich sind, oder kleiner als null, wenn der Wert dieses Objekts kleiner als der von o ist. Der Rückgabewert ist größer als null, wenn der Wert dieses Objekts größer als der von o ist.

Exception: ClassCastException

• Falls für o kein Exemplar von BigInteger übergeben wird.

public BigInteger divide(BigInteger val)

Liefert ein neues BigInteger-Objekt, das das Ergebnis der Ganzzahldivision dieses Objekts durch val enthält.

Exception: ArithmeticException

• Falls val null ist.

public BigInteger[] divideAndRemainder(BigInteger val)

Liefert ein Array aus zwei BigInteger-Objekten. Das erste Element enthält das Ergebnis der Ganzzahldivision dieses Objekts durch val, das zweite den Divisionsrest.

Exception: ArithmeticException

• Falls val null ist.

public double doubleValue()

Konvertiert den Wert des Objekts in einen double-Wert. Falls der Wert des Objekts zu groß ist, um ihn mit double darzustellen, resultiert einer der beiden Unendlich-Werte.

public boolean equals(Object x)

Liefert true, wenn x ein Exemplar von BigInteger ist, das denselben Wert besitzt wie dieses Objekt, sonst false.

public BigInteger flipBit(int n)

Negiert das Bit an der Position n.

Exception: ArithmeticException

• Falls n kleiner als null ist.

public float floatValue()

Konvertiert den Wert des Objekts in einen float-Wert. Falls der Wert des Objekts zu groß ist, um ihn mit float darzustellen, resultiert einer der beiden Unendlich-Werte.

public BigInteger gcd(BigInteger val)

Liefert den größten gemeinsamen Teiler von val und diesem Objekt.

public int getLowestSetBit()

Liefert die Position des niederwertigsten gesetzten Bits.

public int hashCode()

Liefert einen Hashcode für das BigInteger-Objekt.

public int intValue()

Konvertiert den Wert des Objekts in einen int-Wert. Falls der Wert des Objekts zu groß ist, um ihn mit int darzustellen, resultiert einer der beiden Unendlich-Werte.

public boolean isProbablePrime(int certainty)

Liefert true, falls dieses Objekt mit einer Wahrscheinlichkeit von 1-2 hoch certainty eine Primzahl ist, oder false, wenn es mit Sicherheit keine Primzahl ist.

public long longValue()

Konvertiert den Wert des Objekts in einen long-Wert. Falls der Wert des Objekts zu groß ist, um ihn mit long darzustellen, resultiert einer der beiden Unendlich-Werte.

public BigInteger max(BigInteger val)

Liefert das Maximum von val und diesem Objekt.

public BigInteger min(BigInteger val)

Liefert das Minimum von val und diesem Objekt.

public BigInteger mod(BigInteger m)

Liefert den Divisionsrest von diesem Objekt mit dem Divisor m in einem neuen BigInteger-Objekt zurück.

Exception: ArithmeticException

• Falls m kleiner gleich null ist.

public BigInteger modInverse(BigInteger m)

Liefert das inverse Element zu diesem Objekt bezüglich der Multiplikation im Restklassenring modulo m.

Exception: ArithmeticException

• Falls m nicht positiv ist.
• Wenn es kein inverses Element gibt.

public BigInteger modPow(BigInteger exponent, BigInteger m)

Liefert den Wert dieses Objekts hoch exponent modulo m.

public BigInteger multiply(BigInteger val)

Liefert ein neues BigInteger-Objekt, das das Produkt von val und diesem Objekt enthält.

public BigInteger negate()

Liefert ein neues BigInteger-Objekt, das den negierten Wert dieses Objekts enthält.

public BigInteger not()

Liefert ein neues BigInteger-Objekt zurück, das die bitweise Negation dieses Objekts enthält.

public BigInteger or(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die bitweise Oder-Verknüpfung von val mit diesem Objekt enthält.

public BigInteger pow(int exponent)

Liefert ein neues BigInteger-Objekt zurück, das den Wert dieses Objekts potenziert mit exponent enthält. Falls exponent kleiner als null ist, wird eine ArithmeticException ausgelöst.

Exception: ArithmeticException

• Wenn exponent kleiner als null ist.

public static BigInteger probablePrime(int bitLength, Random rnd)     

Liefert eine BigInteger mit bitLength Bits zurück, die mit hoher Wahrscheinlichkeit prim ist. Die Wahrscheinlichkeit, daß sie nicht prim ist, liegt unter 2 hoch -100. Für die Ermittlung der Primzahlkandidaten wird der Zufallszahlengenerator rnd benutzt.

Exception: ArithmeticException

• Wenn bitLength kleiner als Zwei ist.

public BigInteger remainder(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das den Rest der Ganzzahldivision dieses Objekts durch val enthält.

Exception: ArithmeticException

• Falls val null ist.

public BigInteger setBit(int n)

Setzt das Bit an der Position n. Wenn n negativ ist, wird eine ArithmeticException ausgelöst.

Exception: ArithmeticException

• Falls n kleiner als null ist.

public BigInteger shiftLeft(int n)

Liefert den Wert dieses Objekts um n Bitpositionen nach links verschoben in einem neuen BigInteger-Objekt zurück. Wenn für n ein negativer Wert angegeben wird, werden die Bits nach rechts verschoben.

public BigInteger shiftRight(int n)

Liefert den Wert dieses Objekts um n Bitpositionen nach rechts verschoben in einem neuen BigInteger-Objekt zurück. Die linken Bits werden mit Nullen aufgefüllt, wobei das Vorzeichen erhalten bleibt. Wenn für n ein negativer Wert angegeben wird, werden die Bits nach links verschoben.

public int signum()

Liefert 1, wenn der Wert positiv, 0, wenn der Wert null, oder -1, wenn der Wert negativ ist.

public BigInteger subtract(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die Differenz von diesem Objekt und val enthält.

public boolean testBit(int n)

Prüft, ob das Bit an der Position n gesetzt ist. Ist das der Fall, wird true zurückgeliefert, sonst false.

Exception: ArithmeticException

• Falls n kleiner als null ist.

public byte[] toByteArray()

Liefert die Zweier-Komplement-Darstellung in einem byte-Array zurück.

public String toString()

Konvertiert den Wert des BigInteger-Objekts in einen String, wobei für das Zehnersystem verwendet wird.

public String toString(int radix)

Konvertiert den Wert des BigInteger-Objekts in einen String, wobei das mit radix festgelegte Zahlensystem verwendet wird.

public static BigInteger valueOf(long val)

Liefert ein neues BigDecimal-Objekt zurück, das den Wert val enthält.

public BigInteger xor(BigInteger val)

Liefert ein neues BigInteger-Objekt zurück, das die bitweise Exklusiv-Oder-Verknüpfung von val mit diesem Objekt enthält.