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

Deklaration

Beschreibung

Methoden
public BigDecimal	abs()
public BigDecimal	add(BigDecimal val)
public int	compareTo(BigDecimal val)
public int	compareTo(Object o)
public BigDecimal	divide(BigDecimal val, int roundingMode)
public BigDecimal	divide(BigDecimal val, int scale, int roundingMode)
public double	doubleValue()
public boolean	equals(Object x)
public float	floatValue()
public int	hashCode()
public int	intValue()
public long	longValue()
public BigDecimal	max(BigDecimal val)
public BigDecimal	min(BigDecimal val)
public BigDecimal	movePointLeft(int n)
public BigDecimal	movePointRight(int n)
public BigDecimal	multiply(BigDecimal val)
public BigDecimal	negate()
public int	scale()
public BigDecimal	setScale(int scale)
public BigDecimal	setScale(int scale, int roundingMode)
public int	signum()
public BigDecimal	subtract(BigDecimal val)
public BigInteger	toBigInteger()
public String	toString()
public BigInteger	unscaledValue()
public static BigDecimal	valueOf(long val)
public static BigDecimal	valueOf(long val, int scale)

Datenelemente im Detail

public final static int ROUND_UP

Spezifiziert betragsmäßiges Aufrunden (Runden von null weg).

public final static int ROUND_DOWN

Spezifiziert Runden durch Abschneiden (Runden auf null zu).

public final static int ROUND_CEILING

Spezifiziert Runden auf die kleinste Zahl der neuen Genauigkeit, die größer als der momentane Wert ist.

public final static int ROUND_FLOOR

Spezifiziert Runden auf die größte Zahl der neuen Genauigkeit, die kleiner als der momentane Wert ist.

public final static int ROUND_HALF_UP

Rundet auf, wenn der Nachkommateil größer oder gleich 0.5 ist, sonst wird abgerundet.

public final static int ROUND_HALF_DOWN

Rundet auf, wenn der Nachkommateil größer 0.5 ist, sonst wird abgerundet.

public final static int ROUND_HALF_EVEN

Rundet nach dem Verfahren ROUND_HALF_UP, wenn die Ziffer links von den zu rundenden Stellen ungerade ist, oder nach ROUND_HALF_DOWN, wenn sie gerade ist (Runden zum nächsten Nachbarn).

public final static int ROUND_UNNECESSARY

Bewirkt, daß eine ArithmeticException ausgelöst wird, wenn eine Operation ausgeführt wird, die eine Rundung erfordert.

Konstruktoren im Detail

public BigDecimal(String val)

Erzeugt ein neues BigDecimal-Objekt aus dem String val. Dieser kann auch vorzeichenbehaftet sein oder in der Exponentialnotation übergeben werden.

Exception: NumberFormatException

• Falls val kein gültiger Ziffernstring ist.

public BigDecimal(double val)

Erzeugt ein neues BigDecimal-Objekt aus dem double-Wert val.

Exception: NumberFormatException

• Falls val einen Unendlichen Wert oder den Wert NaN hat.

public BigDecimal(BigInteger val)

Erzeugt ein neues BigDecimal-Objekt aus einer BigInteger.

public BigDecimal(BigInteger val, int scale)

Erzeugt ein neues BigDecimal-Objekt aus der BigInteger val mit scale Nachkommastellen.

Exception: NumberFormatException

• Wenn scale kleiner als null ist.

Methoden im Detail

public BigDecimal abs()

Liefert den Betrag zurück.

public BigDecimal add(BigDecimal val)

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

public int compareTo(BigDecimal 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. Zwei BigDecimal-Objekte gelten als gleich, wenn sie exakt denselben Wert haben, auch dann, wenn die Anzahl der Nachkommastellen unterschiedlich ist (1.0 und 1.000).

public int compareTo(Object o)     

Vergleicht den Wert dieses Objekts mit dem des Parameters o, für den ein BigDecimal-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 BigDecimal übergeben wird.

public BigDecimal divide(BigDecimal val, int roundingMode)     

Liefert ein neues BigDecimal-Objekt, das den Qoutienten der Division dieses Objekts durch val enthält. Das Ergebnis erhält scale Nachkommastellen. Mit roundingMode wird das Rundungsverfahren festgelegt.

Exception: ArithmeticException

Exception: IllegalArgumentException

• Wenn ein ungültiger Rundungsmodus angegeben wird.

public BigDecimal divide(BigDecimal val, int scale, int roundingMode)

Liefert ein neues BigDecimal-Objekt, das den Qoutienten der Division dieses Objekts durch val enthält. Das Ergebnis erhält scale Nachkommastellen. Mit roundingMode wird das Rundungsverfahren festgelegt.

Exception: ArithmeticException

• Falls scale kleiner als null ist.

Exception: IllegalArgumentException

• Wenn ein ungültiger Rundungsmodus angegeben wird.

public double doubleValue()

Konvertiert den Wert des Objekts gemäß den üblichen Konvertierungsregeln für numerische Datentypen in einen double-Wert. Entsprechend resultiert einer der beiden Unendlich-Werte, falls der Wert des Objekts zu groß ist, um ihn mit double darzustellen.

public boolean equals(Object x)

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

public float floatValue()

Konvertiert den Wert des Objekts gemäß den üblichen Konvertierungsregeln für numerische Datentypen in einen float-Wert. Entsprechend resultiert einer der beiden Unendlich-Werte, falls der Wert des Objekts zu groß ist, um ihn mit float darzustellen.

public int hashCode()

Liefert einen Hashcode für das BigDecimal-Objekt.

public int intValue()

Konvertiert den Wert des Objekts gemäß den üblichen Konvertierungsregeln für numerische Datentypen in einen int-Wert. Entsprechend resultiert einer der beiden Unendlich-Werte, falls der Wert des Objekts zu groß ist, um ihn mit int darzustellen.

public long longValue()

Konvertiert den Wert des Objekts gemäß den üblichen Konvertierungsregeln für numerische Datentypen in einen long-Wert. Entsprechend resultiert einer der beiden Unendlich-Werte, falls der Wert des Objekts zu groß ist, um ihn mit long darzustellen.

public BigDecimal max(BigDecimal val)

Liefert das Maximum von val und diesem Objekt.

public BigDecimal min(BigDecimal val)

Liefert das Minimum von val und diesem Objekt.

public BigDecimal movePointLeft(int n)

Verschiebt das Komma um n Stellen nach links. Hierdurch wird der Wert der Zahl geändert, ohne die Genauigkeit zu beeinträchtigen. Wenn für n eine negative Zahl angegeben wird, wird das Komma nach rechts verschoben.

public BigDecimal movePointRight(int n)

Verschiebt das Komma um n Stellen nach rechts. Hierdurch wird der Wert der Zahl geändert, ohne die Genauigkeit zu beeinträchtigen. Wenn für n eine negative Zahl angegeben wird, wird das Komma nach links verschoben.

public BigDecimal multiply(BigDecimal val)

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

public BigDecimal negate()

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

public int scale()

Liefert den Exponenten des Objekts.

public BigDecimal setScale(int scale)

Setzt die Anzahl der Nachkommastellen auf scale.

Exception: ArithmeticException

• Falls scale kleiner als null ist oder bei der Änderung des Exponenten eine Rundung erforderlich wird.

Exception: IllegalArgumentException

public BigDecimal setScale(int scale, int roundingMode)

Setzt die Anzahl der Nachkommastellen auf scale und benutzt gegebenenfalls das durch roundingMode spezifizierte Rundungsverfahren.

Exception: ArithmeticException

• Falls scale kleiner als null ist.
• Wenn bei der Änderung der Stellen eine Rundung erforderlich wird.

Exception: IllegalArgumentException

• Wenn ein ungültiger Wert für roundingMode angegeben wird.

public int signum()

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

public BigDecimal subtract(BigDecimal val)

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

public BigInteger toBigInteger()

Konvertiert den Wert des Objekts gemäß den üblichen Konvertierungsregeln für numerische Datentypen in einen BigInteger-Wert und liefert ihn zurück.

public String toString()

Liefert den Wert des BigDecimal-Objekts vollständig ausgeschrieben in einem String.

public BigInteger unscaledValue()     

Liefert die Mantisse in einem neuen BigInteger-Objekt zurück.

public static BigDecimal valueOf(long val)

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

public static BigDecimal valueOf(long val, int scale)

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

Exception: NumberFormatException

• Falls scale kleiner als null ist.