BigDecimal 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| BigDecimal(BigInteger) |
將 |
| BigDecimal(Char[], Int32, Int32, MathContext) |
將的 |
| BigDecimal(Char[], Int32, Int32) |
將的 |
| BigDecimal(BigInteger, Int32, MathContext) |
將 |
| BigDecimal(String, MathContext) |
將的 |
| BigDecimal(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
| BigDecimal(Int64, MathContext) |
將 |
| BigDecimal(Double, MathContext) |
將 |
| BigDecimal(Int32, MathContext) |
將 |
| BigDecimal(BigInteger, Int32) |
將 |
| BigDecimal(BigInteger, MathContext) |
根據內容設定， |
| BigDecimal(String) |
將字 |
| BigDecimal(Int64) |
將 |
| BigDecimal(Int32) |
將 |
| BigDecimal(Double) |
將 |
| BigDecimal(Char[]) |
將的 |
| BigDecimal(Char[], MathContext) |
將的 |
BigDecimal(BigInteger)
將 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的值。
- 屬性
備註
的 java.math.BigDecimal.BigDecimal(java.math.BigInteger)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Char[], Int32, Int32, MathContext)
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與建構函式相同的字元 #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 陣列，這是字元的來源。
- offset
- Int32
陣列中要檢查的第一個字元。
- len
- Int32
要考慮的字元數。
- mc
- MathContext
要使用的內容。
- 屬性
例外狀況
如果 為 ，則為 ， offset = in.length如果 in 不包含大十進位的有效字串表示。
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(char[], int, int, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Char[], Int32, Int32)
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與 #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 陣列，這是字元的來源。
- offset
- Int32
陣列中要檢查的第一個字元。
- len
- Int32
要考慮的字元數。
- 屬性
例外狀況
如果 為 ，則為 ， offset = in.length如果 in 不包含大十進位的有效字串表示。
備註
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與 #BigDecimal(String) 建構函式相同的字元序列，同時允許指定子陣列。
已在1.5中新增。
的 java.math.BigDecimal.BigDecimal(.*char[], .*int, .*int)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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
的 unscaled 值 BigDecimal。
- scale
- Int32
小 BigDecimal數字數。
- mc
- MathContext
要使用的內容。
- 屬性
例外狀況
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
如果 為 ，則為 unscaledVal == null。
備註
的 java.math.BigDecimal.BigDecimal(java.math.BigInteger, int, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(String, MathContext)
將的 BigDecimal 字串表示轉譯為 BigDecimal，接受與 #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
要使用的內容。
- 屬性
例外狀況
如果 val 不包含大十進位的有效字串表示。
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(java.lang.String, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(IntPtr, JniHandleOwnership)
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
protected BigDecimal (IntPtr javaReference, Android.Runtime.JniHandleOwnership transfer);new Java.Math.BigDecimal : nativeint * Android.Runtime.JniHandleOwnership -> Java.Math.BigDecimal參數
- transfer
- JniHandleOwnership
JniHandleOwnership，指出如何處理javaReference
備註
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Int64, MathContext)
將 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
要使用的內容。
- 屬性
例外狀況
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(long, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Double, MathContext)
將 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
要使用的內容。
- 屬性
例外狀況
如果 val 是無限大或不是數位，則為 。
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(double, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Int32, MathContext)
將 int 轉譯為 BigDecimal，並根據內容設定四捨五入。
[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
要使用的內容。
- 屬性
例外狀況
如果 mc.precision > 0 和 c.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(int, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
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
的 unscaled 值 BigDecimal。
- scale
- Int32
小 BigDecimal數字數。
- 屬性
例外狀況
如果 為 ，則為 unscaledVal == null。
備註
的 java.math.BigDecimal.BigDecimal(java.math.BigInteger, int)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(BigInteger, MathContext)
根據內容設定， 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
要使用的內容。
- 屬性
例外狀況
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(java.math.BigInteger, java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(String)
將字 BigDecimal 串表示轉換成 BigDecimal。
[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字串表示。
- 屬性
例外狀況
如果 val 不包含大十進位的有效字串表示。
備註
的 java.math.BigDecimal.BigDecimal(java.lang.String)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Int64)
將 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的值。
- 屬性
備註
將 long 轉譯為 BigDecimal。 的刻度 BigDecimal 為零。
已在1.5中新增。
的 java.math.BigDecimal.BigDecimal(.*long)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Int32)
將 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的值。
- 屬性
備註
將 int 轉譯為 BigDecimal。 的刻度 BigDecimal 為零。
已在1.5中新增。
的 java.math.BigDecimal.BigDecimal(.*int)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Double)
將 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的值。
- 屬性
例外狀況
如果 val 是無限大或不是數位，則為 。
備註
將 double 轉譯為 BigDecimal ，這是 之二進位浮點值的確切十進位表示 double法。 傳回 BigDecimal 的 小數字數是最小值， (10<sup>scale</sup> × val) 也就是整數。
<b>Notes：</b><ol><li> 此建構函式的結果可能有些無法預測。 其中一個可能假設在 Java 中撰寫 new BigDecimal(0.1) 時，會建立 BigDecimal 完全等於 0.1 的 （小數位數為 1 的未調整值），但實際上等於 0.10000000000000000005551115123125782702181583404541015625。 這是因為 0.1 不能完全表示為 double （或者，就此事而言，這是任何有限長度的二進位分數）。 因此，傳入<></em> 至建構函式的值不完全等於0.1，儘管出現。
<另一方面，li> 建構函式是完全可預測的：撰寫new BigDecimal("0.1")會建立一個<BigDecimal，其與>0.1 完全相同</em>，如預期String的那樣。 因此，通常建議使用 #BigDecimal（String） String 建構函式來偏好使用此建構函式。
<li> 當 double 必須使用 做為 的來源BigDecimal時，請注意，這個建構函式會提供確切的轉換;它不會提供與使用 Double#toString(double) 方法轉換成 doubleString ，然後使用 建#BigDecimal(String)構函式相同的結果。 若要取得該結果，請使用 static#valueOf(double) 方法。 </老>
的 java.math.BigDecimal.BigDecimal(.*double)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Char[])
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與建構函式相同的字元 #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 陣列，這是字元的來源。
- 屬性
例外狀況
如果 in 不包含大十進位的有效字串表示。
備註
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與建構函式相同的字元 #BigDecimal(String) 序列。
已在1.5中新增。
的 java.math.BigDecimal.BigDecimal(.*char[])Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
BigDecimal(Char[], MathContext)
將的 BigDecimal 字元陣列表示轉譯為 BigDecimal，接受與 #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 陣列，這是字元的來源。
- mc
- MathContext
要使用的內容。
- 屬性
例外狀況
如果 in 不包含大十進位的有效字串表示。
如果 mc.precision > 0 和 mc.roundingMode ==
UNNECESSARY 和 新的大十進位數無法在指定的有效位數內表示，而不捨入。
備註
的 java.math.BigDecimal.BigDecimal(char[], java.math.MathContext)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。