BigDecimal 建構函式

定義

命名空間:: Java.Math

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
BigDecimal(BigInteger)	將 a `BigInteger` 轉換成 `BigDecimal`。
BigDecimal(Char[], Int32, Int32, MathContext)	將的`BigDecimalBigDecimal`字元陣列表示轉換為接受與`#BigDecimal(String)`建構子相同的字元序列，同時允許指定子陣列，並依上下文設定進行四捨五入。
BigDecimal(Char[], Int32, Int32)	將的`BigDecimalBigDecimal`字元陣列表示轉換為，接受與`#BigDecimal(String)`建構子相同的字元序列，同時允許指定子陣列。
BigDecimal(BigInteger, Int32, MathContext)	將 `BigInteger` 未調整的值與刻 `int` 度 `BigDecimal`轉換為，並依上下文設定四捨五入。
BigDecimal(String, MathContext)	將的`BigDecimalBigDecimal`字串表示轉換為，接受與`#BigDecimal(String)`建構子相同的字串，並依上下文設定四捨五入。
BigDecimal(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
BigDecimal(Int64, MathContext)	將 a `long` 轉換為 `BigDecimal`，並依上下文設定四捨五入。
BigDecimal(Double, MathContext)	將 a `double` 轉換為 `BigDecimal`，並依上下文設定四捨五入。
BigDecimal(Int32, MathContext)	將轉換為 `intBigDecimal`，並依上下文設定四捨五入。
BigDecimal(BigInteger, Int32)	將 `BigInteger` 未調整的值和一個 `int` 刻度轉換成 `BigDecimal`。
BigDecimal(BigInteger, MathContext)	根據上下文設定，將 a `BigInteger` 轉換成 `BigDecimal` 四捨五入。
BigDecimal(String)	將的`BigDecimalBigDecimal`字串表示轉換為。
BigDecimal(Int64)	將 a `long` 轉換成 `BigDecimal`。
BigDecimal(Int32)	將 a `int` 轉換成 `BigDecimal`。
BigDecimal(Double)	將 a `double` 轉換為， `BigDecimal` 即的二進位浮點數值的精確十進位表示 `double`。
BigDecimal(Char[])	將的`BigDecimalBigDecimal`字元陣列表示轉換為接受與建構子相同字元`#BigDecimal(String)`序列的。
BigDecimal(Char[], MathContext)	將的`BigDecimalBigDecimal`字元陣列表示轉換為，接受與`#BigDecimal(String)`建構子相同的字元序列，並依上下文設定進行捨入。

BigDecimal(BigInteger)

將 a BigInteger 轉換成 BigDecimal。

[Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;)V", "")]
public BigDecimal(Java.Math.BigInteger? val);

[<Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;)V", "")>]
new Java.Math.BigDecimal : Java.Math.BigInteger -> Java.Math.BigDecimal

參數

val: BigInteger

BigInteger 將值轉換為 BigDecimal。

屬性: RegisterAttribute

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.math.BigInteger)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Char[], Int32, Int32, MathContext)

將的BigDecimalBigDecimal字元陣列表示轉換為接受與#BigDecimal(String)建構子相同的字元序列，同時允許指定子陣列，並依上下文設定進行四捨五入。

[Android.Runtime.Register(".ctor", "([CIILjava/math/MathContext;)V", "")]
public BigDecimal(char[]? in, int offset, int len, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "([CIILjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : char[] * int * int * Java.Math.MathContext -> Java.Math.BigDecimal

參數

in: Char[]

char array 是字元的來源。

offset: Int32

陣列中第一個要檢查的字元。

len: Int32

需要考慮的角色數量。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

NumberFormatException

若 offset = in.length，或若 in 不包含大十進位的有效字串表示。

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(char[], int, int, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Char[], Int32, Int32)

將的BigDecimalBigDecimal字元陣列表示轉換為，接受與#BigDecimal(String)建構子相同的字元序列，同時允許指定子陣列。

[Android.Runtime.Register(".ctor", "([CII)V", "")]
public BigDecimal(char[]? in, int offset, int len);

[<Android.Runtime.Register(".ctor", "([CII)V", "")>]
new Java.Math.BigDecimal : char[] * int * int -> Java.Math.BigDecimal

參數

in: Char[]

char array 是字元的來源。

offset: Int32

陣列中第一個要檢查的字元。

len: Int32

需要考慮的角色數量。

屬性: RegisterAttribute

例外狀況

NumberFormatException

若 offset = in.length，或若 in 不包含大十進位的有效字串表示。

備註

將的BigDecimalBigDecimal字元陣列表示轉換為，接受與#BigDecimal(String)建構子相同的字元序列，同時允許指定子陣列。

已在1.5中新增。

Java 文件 java.math.BigDecimal.BigDecimal(.*char[], .*int, .*int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(BigInteger, Int32, MathContext)

將 BigInteger 未調整的值與刻 int 度 BigDecimal轉換為，並依上下文設定四捨五入。

[Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;ILjava/math/MathContext;)V", "")]
public BigDecimal(Java.Math.BigInteger? unscaledVal, int scale, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;ILjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : Java.Math.BigInteger * int * Java.Math.MathContext -> Java.Math.BigDecimal

參數

unscaledVal: BigInteger

未調整的值。BigDecimal

scale: Int32

的尺度。BigDecimal

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

NullPointerException

如果 unscaledVal == null。

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.math.BigInteger, int, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(String, MathContext)

將的BigDecimalBigDecimal字串表示轉換為，接受與#BigDecimal(String)建構子相同的字串，並依上下文設定四捨五入。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/math/MathContext;)V", "")]
public BigDecimal(string? val, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;Ljava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : string * Java.Math.MathContext -> Java.Math.BigDecimal

參數

val: String

字串表示。BigDecimal

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 val 不包含一個大十進位的有效字串表示。

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.lang.String, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(IntPtr, JniHandleOwnership)

用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

protected BigDecimal(IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);

new Java.Math.BigDecimal : nativeint * Android.Runtime.JniHandleOwnership -> Java.Math.BigDecimal

參數

javaReference: IntPtr
nativeint

IntPtrA 包含一個 Java 原生介面（JNI）物件參考。

transfer: JniHandleOwnership

JniHandleOwnershipA 指示如何處理javaReference

備註

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Int64, MathContext)

將 a long 轉換為 BigDecimal，並依上下文設定四捨五入。

[Android.Runtime.Register(".ctor", "(JLjava/math/MathContext;)V", "")]
public BigDecimal(long val, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(JLjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : int64 * Java.Math.MathContext -> Java.Math.BigDecimal

參數

val: Int64

long 將值轉換為 BigDecimal。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(long, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Double, MathContext)

將 a double 轉換為 BigDecimal，並依上下文設定四捨五入。

[Android.Runtime.Register(".ctor", "(DLjava/math/MathContext;)V", "")]
public BigDecimal(double val, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(DLjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : double * Java.Math.MathContext -> Java.Math.BigDecimal

參數

val: Double

double 將值轉換為 BigDecimal。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 val 是無限大，是否是無窮大。

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(double, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Int32, MathContext)

將轉換為 intBigDecimal，並依上下文設定四捨五入。

[Android.Runtime.Register(".ctor", "(ILjava/math/MathContext;)V", "")]
public BigDecimal(int val, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(ILjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : int * Java.Math.MathContext -> Java.Math.BigDecimal

參數

val: Int32

int 將值轉換為 BigDecimal。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

ArithmeticException

若 mc.precision > 0 和 c.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(int, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(BigInteger, Int32)

將 BigInteger 未調整的值和一個 int 刻度轉換成 BigDecimal。

[Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;I)V", "")]
public BigDecimal(Java.Math.BigInteger? unscaledVal, int scale);

[<Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;I)V", "")>]
new Java.Math.BigDecimal : Java.Math.BigInteger * int -> Java.Math.BigDecimal

參數

unscaledVal: BigInteger

未調整的值。BigDecimal

scale: Int32

的尺度。BigDecimal

屬性: RegisterAttribute

例外狀況

NullPointerException

如果 unscaledVal == null。

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.math.BigInteger, int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(BigInteger, MathContext)

根據上下文設定，將 a BigInteger 轉換成 BigDecimal 四捨五入。

[Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;Ljava/math/MathContext;)V", "")]
public BigDecimal(Java.Math.BigInteger? val, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "(Ljava/math/BigInteger;Ljava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : Java.Math.BigInteger * Java.Math.MathContext -> Java.Math.BigDecimal

參數

val: BigInteger

BigInteger 將值轉換為 BigDecimal。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.math.BigInteger, java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(String)

將的BigDecimalBigDecimal字串表示轉換為。

[Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")]
public BigDecimal(string? val);

[<Android.Runtime.Register(".ctor", "(Ljava/lang/String;)V", "")>]
new Java.Math.BigDecimal : string -> Java.Math.BigDecimal

參數

val: String

的 BigDecimal字串表示。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 val 不包含一個大十進位的有效字串表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Int64)

將 a long 轉換成 BigDecimal。

[Android.Runtime.Register(".ctor", "(J)V", "")]
public BigDecimal(long val);

[<Android.Runtime.Register(".ctor", "(J)V", "")>]
new Java.Math.BigDecimal : int64 -> Java.Math.BigDecimal

參數

val: Int64

long 將值轉換為 BigDecimal。

屬性: RegisterAttribute

備註

將 a long 轉換成 BigDecimal。的比例 BigDecimal 是零。

已在1.5中新增。

Java 文件 java.math.BigDecimal.BigDecimal(.*long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Int32)

將 a int 轉換成 BigDecimal。

[Android.Runtime.Register(".ctor", "(I)V", "")]
public BigDecimal(int val);

[<Android.Runtime.Register(".ctor", "(I)V", "")>]
new Java.Math.BigDecimal : int -> Java.Math.BigDecimal

參數

val: Int32

int 將值轉換為 BigDecimal。

屬性: RegisterAttribute

備註

將 a int 轉換成 BigDecimal。的比例 BigDecimal 是零。

已在1.5中新增。

Java 文件 java.math.BigDecimal.BigDecimal(.*int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Double)

將 a double 轉換為， BigDecimal 即的二進位浮點數值的精確十進位表示 double。

[Android.Runtime.Register(".ctor", "(D)V", "")]
public BigDecimal(double val);

[<Android.Runtime.Register(".ctor", "(D)V", "")>]
new Java.Math.BigDecimal : double -> Java.Math.BigDecimal

參數

val: Double

double 將值轉換為 BigDecimal。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 val 是無限大，是否是無窮大。

備註

將 a double 轉換為， BigDecimal 即的二進位浮點數值的精確十進位表示 double。回傳 BigDecimal 的尺度是最小的 (10scale × val) 整數值。

註解：<ol><li> 這個構造器的結果可能有些難以預測。有人可能會以為用 Java 書寫new BigDecimal(0.1)會產生BigDecimal一個，它恰好等於 0.1（一個未縮放的值 1，縮放為 1），但實際上它等於 0.10000000000000000005511151231257827021181583404541015625。這是因為 0.1 無法精確表示為（ double 或說，任何有限長度的二進位分數）。因此，傳<入 em> 建構子的值並不完全等於 0.1，儘管外觀不符。

<另一方面>String，構造子是完全可預測的：寫new BigDecimal("0.1")入會產生一個，使BigDecimal得 完全等<>於 0.1，正如預期的那樣。因此，一般建議優先使用 #BigDecimal（字串）字串建構子，而非此構造器。

<li> 當必須使用 a double 作為的來源BigDecimal時，請注意此構造器提供精確轉換;它不像用 double 方法將轉換為 String a Double#toString(double) 再用#BigDecimal(String)建構子得到相同的結果。要達到這個效果，就用這個 static#valueOf(double) 方法。 </ol>

Java 文件 java.math.BigDecimal.BigDecimal(.*double)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Char[])

將的BigDecimalBigDecimal字元陣列表示轉換為接受與建構子相同字元#BigDecimal(String)序列的。

[Android.Runtime.Register(".ctor", "([C)V", "")]
public BigDecimal(char[]? in);

[<Android.Runtime.Register(".ctor", "([C)V", "")>]
new Java.Math.BigDecimal : char[] -> Java.Math.BigDecimal

參數

in: Char[]

char array 是字元的來源。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 in 不包含一個大十進位的有效字串表示。

備註

將的BigDecimalBigDecimal字元陣列表示轉換為接受與建構子相同字元#BigDecimal(String)序列的。

已在1.5中新增。

Java 文件 java.math.BigDecimal.BigDecimal(.*char[])。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

BigDecimal(Char[], MathContext)

將的BigDecimalBigDecimal字元陣列表示轉換為，接受與#BigDecimal(String)建構子相同的字元序列，並依上下文設定進行捨入。

[Android.Runtime.Register(".ctor", "([CLjava/math/MathContext;)V", "")]
public BigDecimal(char[]? in, Java.Math.MathContext? mc);

[<Android.Runtime.Register(".ctor", "([CLjava/math/MathContext;)V", "")>]
new Java.Math.BigDecimal : char[] * Java.Math.MathContext -> Java.Math.BigDecimal

參數

in: Char[]

char array 是字元的來源。

mc: MathContext

需要說明的背景。

屬性: RegisterAttribute

例外狀況

NumberFormatException

如果 in 不包含一個大十進位的有效字串表示。

ArithmeticException

若 mc.precision > 0 和 mc.roundingMode == UNNECESSARY ，則新大十進位無法在不四捨五入的情況下以指定精度表示。

備註

Java 文件 java.math.BigDecimal.BigDecimal(char[], java.math.MathContext)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於