BigInteger.ToString メソッド

ソース:

BigInteger.cs

ソース:

BigInteger.cs

ソース:

BigInteger.cs

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString (string format, IFormatProvider provider);

public string ToString (string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

パラメーター

戻り値

format パラメーターと providerパラメーターで指定されている現在の BigInteger 値の文字列表現。

実装

例外

例

次の例では、値を BigInteger 初期化し、標準の書式指定文字列と NumberFormatInfo 、チルダ (~) を負の符号として定義する オブジェクトを使用してコンソールに表示します。

// Redefine the negative sign as the tilde for the invariant culture.
NumberFormatInfo bigIntegerFormatter = new NumberFormatInfo();
bigIntegerFormatter.NegativeSign = "~";

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier,
                     bigIntegerFormatter));

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

    // Redefine the negative sign as the tilde for the invariant culture.
    let bigIntegerFormatter = NumberFormatInfo()
    bigIntegerFormatter.NegativeSign <- "~"

    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{specifier}: {value.ToString(specifier, bigIntegerFormatter)}"

// The example displays the following output:
//    C: (☼903,145,792,771,643,190,182.00)
//    D: ~903145792771643190182
//    D25: ~0000903145792771643190182
//    E: ~9.031457E+020
//    E4: ~9.0314E+020
//    e8: ~9.03145792e+020
//    F0: ~903145792771643190182
//    G: ~903145792771643190182
//    N0: ~903,145,792,771,643,190,182
//    P: ~90,314,579,277,164,319,018,200.00 %
//    R: ~903145792771643190182
//    X: CF0A55968BB1A7545A
//    0,0.000: ~903,145,792,771,643,190,182.000
//    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

' Redefine the negative sign as the tilde for the invariant culture.
Dim bigIntegerFormatter As New NumberFormatInfo()
bigIntegerFormatter.NegativeSign = "~"

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier, 
                     bigIntegerformatter))
Next   
' The example displays the following output:
'    C: (☼903,145,792,771,643,190,182.00)
'    D: ~903145792771643190182
'    D25: ~0000903145792771643190182
'    E: ~9.031457E+020
'    E4: ~9.0314E+020
'    e8: ~9.03145792e+020
'    F0: ~903145792771643190182
'    G: ~903145792771643190182
'    N0: ~903,145,792,771,643,190,182
'    P: ~90,314,579,277,164,319,018,200.00 %
'    R: ~903145792771643190182
'    X: CF0A55968BB1A7545A
'    0,0.000: ~903,145,792,771,643,190,182.000
'    #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

注釈

メソッドは ToString(String, IFormatProvider) 、 BigInteger 指定したカルチャの オブジェクトを使用して、 NumberFormatInfo 指定した形式で値の書式を設定します。 ラウンドトリップ形式または既定のカルチャ設定を使用する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

パラメーターには format 、任意の有効な 標準数値文字列、または カスタム数値書式指定文字列の任意の組み合わせを指定できます。 が または のString.Emptynull場合format、現在BigIntegerのオブジェクトの戻り値はラウンド トリップ書式指定子 ("R") で書式設定されます。 が他の値の場合 format 、 メソッドは を FormatExceptionスローします。

.NET では、以下の書式設定に関するトピックで詳しく説明されている広範な書式設定のサポートが提供されています。

• 数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および「 カスタム数値書式指定文字列」を参照してください。

• .NET での書式設定のサポートの詳細については、「型の 書式設定」を参照してください。

パラメーターは provider 実装です IFormatProvider 。 そのメソッドは GetFormat 、 NumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する オブジェクトを返します。 メソッドがToString(String, IFormatProvider)呼び出されると、パラメーターの GetFormat メソッドがprovider呼び出され、型をType表すオブジェクトがNumberFormatInfo渡されます。 次に、 メソッドはGetFormat、負符号記号、グループ区切り記号、小数点記号など、パラメーターの書式設定valueに関する情報を提供する オブジェクトを返NumberFormatInfoします。 パラメーターを使用してメソッドに provider 書式設定情報を指定するには、次の ToString(String, IFormatProvider) 3 つの方法があります。

• 書式設定情報を CultureInfo 提供するカルチャを表す オブジェクトを渡すことができます。 そのメソッドは GetFormat 、そのカルチャの NumberFormatInfo 数値書式情報を提供する オブジェクトを返します。

• 数値書式情報を提供する実際 NumberFormatInfo のオブジェクトを渡すことができます。 (の実装 GetFormat はそれ自体を返すだけです)。

• を実装 IFormatProviderするカスタム オブジェクトを渡すことができます。 そのメソッドは GetFormat 、書式設定情報を提供する オブジェクトを NumberFormatInfo インスタンス化して返します。

が nullの場合provider、返される文字列の書式設定は、現在のNumberFormatInfoカルチャのオブジェクトに基づきます。

こちらもご覧ください

• 標準の数値書式指定文字列
• カスタム数値形式文字列

ソース:

BigInteger.cs

ソース:

BigInteger.cs

ソース:

BigInteger.cs

public:
 System::String ^ ToString(System::String ^ format);

public string ToString (string format);

public string ToString (string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

パラメーター

戻り値

現在の BigInteger 値の文字列形式を、format パラメーターで指定されている形式で表現した値。

例外

例

次の例では、値を BigInteger 初期化し、各標準書式指定文字列といくつかのカスタム書式指定文字列を使用して表示します。

BigInteger value = BigInteger.Parse("-903145792771643190182");
string[] specifiers = { "C", "D", "D25", "E", "E4", "e8", "F0",
                        "G", "N0", "P", "R", "X", "0,0.000",
                        "#,#.00#;(#,#.00#)" };

foreach (string specifier in specifiers)
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));

// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

    // Define a BigInteger value.
    let value = BigInteger.Parse "-903145792771643190182"

    let specifiers =
        [| "C"
           "D"
           "D25"
           "E"
           "E4"
           "e8"
           "F0"
           "G"
           "N0"
           "P"
           "R"
           "X"
           "0,0.000"
           "#,#.00#;(#,#.00#)" |]

    for specifier in specifiers do
        printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
//       C: ($903,145,792,771,643,190,182.00)
//       D: -903145792771643190182
//       D25: -0000903145792771643190182
//       E: -9.031457E+020
//       E4: -9.0314E+020
//       e8: -9.03145792e+020
//       F0: -903145792771643190182
//       G: -903145792771643190182
//       N0: -903,145,792,771,643,190,182
//       P: -90,314,579,277,164,319,018,200.00 %
//       R: -903145792771643190182
//       X: CF0A55968BB1A7545A
//       0,0.000: -903,145,792,771,643,190,182.000
//       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

Dim value As BigInteger = BigInteger.Parse("-903145792771643190182")
Dim specifiers() As String = { "C", "D", "D25", "E", "E4", "e8", "F0", 
                               "G", "N0", "P", "R", "X", "0,0.000", 
                               "#,#.00#;(#,#.00#)" }

For Each specifier As String In specifiers
   Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next   
' The example displays the following output:
'       C: ($903,145,792,771,643,190,182.00)
'       D: -903145792771643190182
'       D25: -0000903145792771643190182
'       E: -9.031457E+020
'       E4: -9.0314E+020
'       e8: -9.03145792e+020
'       F0: -903145792771643190182
'       G: -903145792771643190182
'       N0: -903,145,792,771,643,190,182
'       P: -90,314,579,277,164,319,018,200.00 %
'       R: -903145792771643190182
'       X: CF0A55968BB1A7545A
'       0,0.000: -903,145,792,771,643,190,182.000
'       #,#.00#;(#,#.00#): (903,145,792,771,643,190,182.00)

注釈

メソッドは ToString(String) 、現在の BigInteger カルチャの規則を表す オブジェクトを NumberFormatInfo 使用して、指定した形式で値の書式を設定します。 "R" またはラウンドトリップを使用する場合は、別のカルチャを書式設定または指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

パラメーターには format 、任意の有効な 標準数値文字列、または カスタム数値書式指定文字列の任意の組み合わせを指定できます。 が または のString.Emptynull場合format、現在BigIntegerのオブジェクトの戻り値はラウンド トリップ書式指定子 ("R") で書式設定されます。 が他の値の場合 format 、 メソッドは を FormatExceptionスローします。

.NET では、以下の書式設定に関するトピックで詳しく説明されている広範な書式設定のサポートが提供されています。

• 数値書式指定子の詳細については、「 標準の数値書式指定文字列 」および「 カスタム数値書式指定文字列」を参照してください。

• .NET での書式設定のサポートの詳細については、「型の 書式設定」を参照してください。

返される文字列の形式は、現在のカルチャの NumberFormatInfo オブジェクトによって決まります。 パラメーターに format 応じて、このオブジェクトは、負符号、グループ区切り記号、出力文字列の小数点記号などの記号を制御します。 現在のカルチャ以外のカルチャの書式設定情報を提供するには、 オーバーロードを ToString(String, IFormatProvider) 呼び出します。

こちらもご覧ください

• 標準の数値書式指定文字列
• カスタム数値形式文字列

ソース:

BigInteger.cs

ソース:

BigInteger.cs

ソース:

BigInteger.cs

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString (IFormatProvider provider);

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

パラメーター

戻り値

現在の BigInteger 値の文字列形式を、provider パラメーターで指定されている形式で表現した値。

例

次の例では、チルダ (~) を負の符号として定義するカスタム NumberFormatInfo オブジェクトをインスタンス化します。 次に、 メソッドは ToString(IFormatProvider) カスタム NumberFormatInfo オブジェクトを使用して負 BigInteger の値を表示します。

BigInteger number = 9867857831128;
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne;

NumberFormatInfo bigIntegerProvider = new NumberFormatInfo();
bigIntegerProvider.NegativeSign = "~";

Console.WriteLine(number.ToString(bigIntegerProvider));

let number = bigint 9867857831128L
let number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

let bigIntegerProvider = NumberFormatInfo()
bigIntegerProvider.NegativeSign <- "~"

printfn $"{number.ToString(bigIntegerProvider)}"

Dim number As BigInteger = 9867857831128
number = BigInteger.Pow(number, 3) * BigInteger.MinusOne

Dim bigIntegerProvider As New NumberFormatInfo()
bigIntegerProvider.NegativeSign = "~"      

Console.WriteLine(number.ToString(bigIntegerProvider))

注釈

メソッドは ToString(IFormatProvider) 、 BigInteger 指定したカルチャの オブジェクトを使用 NumberFormatInfo して、"R" またはラウンド トリップ形式の値の書式を設定します。 別の形式または現在のカルチャを指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

パラメーターは provider 実装です IFormatProvider 。 そのメソッドは GetFormat 、 NumberFormatInfo このメソッドによって返される文字列の形式に関するカルチャ固有の情報を提供する オブジェクトを返します。 が nullの場合provider、BigInteger値は現在のカルチャの オブジェクトをNumberFormatInfo使用して書式設定されます。 一般的な書式指定子を NumberFormatInfo 使用して値の文字列表現を BigInteger 制御する オブジェクトの唯一のプロパティは です NumberFormatInfo.NegativeSign。これは、負符号を表す文字を定義します。

パラメーターには provider 、次のいずれかを指定できます。

• CultureInfo書式設定情報を提供するカルチャを表す オブジェクト。

• NumberFormatInfo書式設定情報を提供する オブジェクト。

• を実装 IFormatProviderするカスタム オブジェクト。 そのメソッドは GetFormat 、書式設定情報を NumberFormatInfo 提供する オブジェクトを返します。

ソース:

BigInteger.cs

ソース:

BigInteger.cs

ソース:

BigInteger.cs

public:
 override System::String ^ ToString();

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

戻り値

現在の BigInteger 値の文字列形式。

例

次の例では、既定ToString()のメソッドをBigInteger使用して値を表示します。 また、一部の標準書式指定子を BigInteger 使用した結果の値の文字列表現も表示されます。 例は、en-US カルチャの書式設定規則を使用して表示されます。

// Initialize a BigInteger value.
BigInteger value = BigInteger.Add(UInt64.MaxValue, 1024);

// Display value using the default ToString method.
Console.WriteLine(value.ToString());
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));
Console.WriteLine(value.ToString("C"));
Console.WriteLine(value.ToString("D"));
Console.WriteLine(value.ToString("F"));
Console.WriteLine(value.ToString("N"));
Console.WriteLine(value.ToString("X"));
// The example displays the following output on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF

    // Initialize a BigInteger value.
    let value = BigInteger.Add(UInt64.MaxValue, 1024)

    // Display value using the default ToString method.
    printfn $"{value.ToString()}"
    // Display value using some standard format specifiers.
    printfn $"""{value.ToString("G")}"""
    printfn $"""{value.ToString("C")}"""
    printfn $"""{value.ToString("D")}"""
    printfn $"""{value.ToString("F")}"""
    printfn $"""{value.ToString("N")}"""
    printfn $"""{value.ToString("X")}"""
// The example displays the following output on a system whose current
// culture is en-US:
//       18446744073709552639
//       18446744073709552639
//       $18,446,744,073,709,552,639.00
//       18446744073709552639
//       18446744073709552639.00
//       18,446,744,073,709,552,639.00
//       100000000000003FF

' Initialize a BigInteger value.
Dim value As BigInteger = BigInteger.Add(UInt64.MaxValue, 1024)

' Display value using the default ToString method.
Console.WriteLine(value.ToString())        
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))
Console.WriteLine(value.ToString("C"))
Console.WriteLine(value.ToString("D"))
Console.WriteLine(value.ToString("F"))
Console.WriteLine(value.ToString("N"))
Console.WriteLine(value.ToString("X"))       
' The example displays the following output on a system whose current 
' culture is en-US:
'       18446744073709552639
'       18446744073709552639
'       $18,446,744,073,709,552,639.00
'       18446744073709552639
'       18446744073709552639.00
'       18,446,744,073,709,552,639.00
'       100000000000003FF

注釈

メソッドは ToString() 、現在の BigInteger カルチャの "R" またはラウンドトリップ形式の値を書式設定します。 別の形式またはカルチャを指定する場合は、次のように メソッドの他のオーバーロードを ToString 使用します。

値の BigInteger 文字列表現には、値が負の場合は負の符号、先頭に 0 を付けずに 0 から 9 までの数字のシーケンスが含まれます。 負の符号は、現在のカルチャの NumberFormatInfo オブジェクトによって定義されます。

こちらもご覧ください

• 標準の数値書式指定文字列
• カスタム数値形式文字列