BigDecimal.Format メソッド

[Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)]
public virtual string? Format(int before, int after);

[<Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)>]
abstract member Format : int * int -> string
override this.Format : int * int -> string

パラメーター

返品

指定したパラメーターに従ってレイアウトされた、このBigDecimalを表すString

属性

RegisterAttribute

注釈

レイアウト パラメーターによって変更された、このBigDecimalのString表現を返します。

このメソッドは、結果のロケール依存の編集を適用できる、より高度なクラス ( DecimalFormat など) で使用するためのプリミティブとして提供されます。 提供される書式設定のレベルは、BigDecimal クラスの必要な部分であり、BigDecimal 算術の計算と丸めルールに従う必要があるためです。 ただし、関数が他の場所で提供されている場合は、このクラスから削除できます。

format メソッドの両方の形式のパラメーターはすべて、int型です。 パラメーターに -1 の値は、そのパラメーターの既定のアクションまたは値を使用する必要があることを示します。

パラメーター before と afterでは、結果の整数部と 10 進数部分に使用する文字数をそれぞれ指定します。 指数表記は使用されません。 いずれかのパラメーターが -1 されている場合 (既定のアクションを示します)、使用される文字数は、その部分に必要な数だけになります。

before は正の数にする必要があります。整数部分を含めるために必要なサイズより大きい場合、その部分は、要求された長さにブランクで左側に埋め込まれます。 before数値の整数部分 (負の数の場合は符号を含む) を含む十分な大きさでない場合は、例外がスローされます。

after は負以外の数値である必要があります。数値の 10 進部分と同じサイズでない場合、数値は丸められます (またはゼロで拡張されます)。 afterに 0 を指定すると、数値は整数に丸められます (つまり、小数点以下の部分も小数点もありません)。 丸め方法は既定の MathContext.ROUND_HALF_UPになります。

その他の丸め方法と指数表記の使用は、 #format(int,int,int,int,int,int)を使用して選択できます。 メソッドの 2 パラメーター形式を使用すると、最後の 4 つのパラメーターがすべて -1 である 6 パラメーター フォームを使用するのとまったく同じ効果があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

[Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)]
public virtual string? Format(int before, int after, int explaces, int exdigits, int exformint, Android.Icu.Math.RoundOptions exround);

[<Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)>]
abstract member Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string
override this.Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string

パラメーター

返品

指定したパラメーターに従ってレイアウトされた、このBigDecimalを表すString

属性

RegisterAttribute

注釈

レイアウト パラメーターによって変更され、指数表記が可能な、このBigDecimalのString表現を返します。

このメソッドは、結果のロケール依存の編集を適用できる、より高度なクラス ( DecimalFormat など) で使用するためのプリミティブとして提供されます。 提供される書式設定のレベルは、BigDecimal クラスの必要な部分であり、BigDecimal 算術の計算と丸めルールに従う必要があるためです。 ただし、関数が他の場所で提供されている場合は、このクラスから削除できます。

パラメーターはすべて int型です。 パラメーターに -1 の値は、そのパラメーターの既定のアクションまたは値を使用する必要があることを示します。

最初の 2 つのパラメーター (before と after) では、 #format(int,int)に定義されているように、結果の整数部と 10 進部分にそれぞれ使用する文字数を指定します。 これらのいずれかが -1 されている場合 (既定のアクションを示します)、使用される文字数は、その部分に必要な数だけになります。

残りのパラメーターは、指数表記と丸めの使用を制御します。 3 (explaces、 exdigits、および exform) は、結果の指数部を制御します。 以前と同様に、これらのパラメーターの既定のアクションは、値 -1 を使用して選択できます。

explaces は正の数にする必要があります。任意の指数部に使用する桁数 (指数部の符号の後の桁数) を設定します。既定値 ( explaces が -1の場合) は必要な数だけ使用されます。 explacesが -1 でない場合、スペースは常に指数に対して予約されます。指数が不要な場合 (指数が 0 の場合など)、explaces+ 2 個の空白が結果に追加されます。 (これは、モノスペース フォントで同様に書式設定された数値の垂直方向の配置を保持します)。 explaces が -1 されておらず、指数を格納するのに十分な大きさでない場合は、例外がスローされます。

exdigits は、指数表記を使用するためのトリガー ポイントを設定します。 丸める前に、小数点が exdigitsを超える前に必要な桁数を超えた場合、または結果の絶対値が 0.000001未満の場合は、 exdigits が指定されている場合、指数形式が使用されます。 exdigitsが -1 の場合、指数表記は使用されません。 exdigitsに 0 を指定すると、指数が 0 でない限り、指数表記が常に使用されます。

exform 指数表記の形式を設定します (必要な場合)。 MathContext#SCIENTIFICまたはMathContext#ENGINEERINGのいずれかです。 後者のエンジニアリングフォームが要求された場合、結果の整数部分 (before ) に最大 3 桁 (負の場合は正符号) が必要になることがあります。 それ以外の場合は、1 桁 (負の場合は正符号) のみが必要です。

最後に、6 番目の引数exroundは、使用する丸めアルゴリズムを選択し、名前が ROUND_ で始まるMathContext クラスのパブリック定数で示される値のいずれかである必要があります。 既定値 (ROUND_HALF_UP) は、前と同様に値 -1 を使用して選択することもできます。

特殊な値 MathContext.ROUND_UNNECESSARY を使用して、0 以外の数字が破棄されるかどうかを検出できます。 exround にこの値がある場合は、書式設定中に 0 以外の数字が破棄 (丸められた) 場合よりも、 ArithmeticException がスローされます。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。