数値書式指定文字列の最大有効桁数

  • [アーティクル]

ToString と TryFormat を使用する文字列として数値を書式設定するときの最大有効桁数が Int32.MaxValue から 999,999,999 に変更されました。 (.NET 6 で最大有効桁数が Int32.MaxValue に以前変更されました)

また、文字列の BigInteger を解析するときに許可される最大指数が 999,999,999 に制限されました。

以前の動作

.NET 6 では、標準の数値書式解析ロジックは Int32.MaxValue 以下の有効桁数に制限されていました。 本来の動作は、Int32.MaxValue より大きい有効桁数に対して FormatException をスローするというものでした。 ただし、バグのために、.NET 6 ではそのような入力に対してその例外がスローされませんでした。 本来の動作は次のようなものでした。

double d = 123.0;

d.ToString("E" + int.MaxValue.ToString()); // Doesn't throw.

long intMaxPlus1 = (long)int.MaxValue + 1;
string intMaxPlus1String = intMaxPlus1.ToString();
Assert.Throws<FormatException>(() => d.ToString("E" + intMaxPlus1String)); // Throws.

また、文字列から BigInteger を解析するとき、指数サイズに制限はありませんでした。

新しい動作

.NET 7 以降では、.NET でサポートされる有効桁数は最大 999,999,999 です。 有効桁数が 999,999,999 を超える場合、FormatException がスローされます。 この変更は、すべての数値型に影響を与える解析ロジックで実装されました。

double d = 123.0;
Assert.Throws<FormatException>(() => d.ToString("E" + int.MaxValue.ToString())); // Throws.

long intMaxPlus1 = (long)int.MaxValue + 1;
string intMaxPlus1String = intMaxPlus1.ToString();
Assert.Throws<FormatException>(() => d.ToString("E" + intMaxPlus1String)); // Throws.

d.ToString("E999999999"); // Doesn't throw.

d.ToString("E00000999999999"); // Doesn't throw.

また、指数が 999,999,999 を超える BigInteger を文字列から解析しようとすると、FormatException がスローされます。

導入されたバージョン

.NET 7

破壊的変更の種類

この変更は、バイナリの互換性に影響を与える可能性があります。

変更理由

.NET 6 で導入された動作は、有効桁数が Int32.MaxValue より大きいときに FormatException をスローするというものでした。 ただし、バグのため、最大値を超える入力に対してその例外はスローされませんでした。 この変更により、有効桁数を 999,999,999 に制限することでバグが修正されます。

ほとんどの場合、書式指定文字列で 999,999,999 を超える有効桁数を既に使用していることは考えられないため、いかなる操作も必要ありません。

影響を受ける API

この変更は、すべての数値型に影響を与える解析ロジックで実装されました。

関連項目