Complex.ToString メソッド

リファレンス

定義

名前空間:: System.Numerics

アセンブリ:: System.Runtime.Numerics.dll

アセンブリ:: System.Numerics.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

複素数の値を等価の文字列形式に変換します。

オーバーロード

ToString(String, IFormatProvider)	現在の複素数の値を、実数部分と虚数部に対して指定された書式およびカルチャ固有の書式情報を使用して、デカルト形式の等価の文字列表現に変換します。
ToString(String)	実数部と虚数部に対して指定した書式を使用して、現在の複素数の値をデカルト形式の等価文字列形式に変換します。
ToString(IFormatProvider)	指定したカルチャ固有の書式情報を使用して、現在の複素数の値をデカルト形式の等価の文字列形式に変換します。
ToString()	現在の複素数の値を、デカルト形式の等価の文字列形式に変換します。

ToString(String, IFormatProvider)

ソース:: Complex.cs

ソース:: Complex.cs

ソース:: Complex.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: String

標準またはカスタムの数値書式指定文字列。

provider: IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

String

format および providerで指定された、デカルト形式の現在のインスタンスの文字列形式。

実装

ToString(String, IFormatProvider)

例外

FormatException

format は有効な書式指定文字列ではありません。

例

次の例では、複素数の配列を作成し、複数の標準書式指定文字列と、英語 - 米国 ("en-US") およびフランス語 - フランス語 ("fr-FR") カルチャを表す CultureInfo オブジェクトを使用して、それぞれを表示します。

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      CultureInfo[] cultures = { new CultureInfo("en-US"),
                                 new CultureInfo("fr-FR") };
      string[] formats = { "F2", "N2", "G5" };

      foreach (Complex c1 in c)
      {
         foreach (string format in formats)
         {
            Console.Write("{0} format string:   ", format);
            foreach (CultureInfo culture in cultures)
               Console.Write("{0} ({1})    ", c1.ToString(format, culture), culture.Name);

            Console.WriteLine();
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//
//    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//
//    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//
//    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]
let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        for culture in cultures do
            printf $"{format} format string: {c1.ToString(format, culture)} ({culture.Name})    "

        printfn ""

    printfn ""
// The example displays the following output:
//    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
//    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//
//    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
//    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//
//    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
//    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//
//    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
//    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") } 
      Dim formats() As String = { "F2", "N2", "G5" } 

      For Each c1 As Complex In c
         For Each format As String In formats
            Console.Write("{0} format string:   ", format)
            For Each culture As CultureInfo In cultures
               Console.Write("{0} ({1})    ", c1.ToString(format, culture), 
                                              culture.Name)
            Next
            Console.WriteLine()
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'    F2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
'    N2 format string:   (17.30, 14.10) (en-US)    (17,30, 14,10) (fr-FR)
'    G5 format string:   (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
'    
'    F2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
'    N2 format string:   (-18.90, 147.20) (en-US)    (-18,90, 147,20) (fr-FR)
'    G5 format string:   (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
'    
'    F2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
'    N2 format string:   (13.47, -18.12) (en-US)    (13,47, -18,12) (fr-FR)
'    G5 format string:   (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
'    
'    F2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
'    N2 format string:   (-11.15, -17.00) (en-US)    (-11,15, -17,00) (fr-FR)
'    G5 format string:   (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

注釈

このメソッドによって返される複素数の文字列表現は、フォーム (または .NET 7 以前のバージョンでは ) のデカルト座標を使用して数値を表示します。ここで、は複素数の実際の部分であり、b はその虚数部分です。と b の両方が、で指定された書式指定文字列を使用して書式設定されます。 format パラメーターには、任意の有効な標準数値書式指定子、またはカスタム数値書式指定子の任意の組み合わせを指定できます。 format が String.Empty に等しいか、nullされている場合、複素数の実数部分と虚数部は、一般的な書式指定子 ("G") で書式設定されます。 format が他の値である場合、メソッドは FormatExceptionをスローします。

.NET では、次の記事で詳しく説明されている広範な書式設定のサポートが提供されています。

数値書式指定文字列の詳細については、「標準の数値書式指定文字列のとカスタム数値書式指定文字列」を参照してください。
.NET での書式設定の詳細については、「書式設定の種類を参照してください。

provider パラメーターは、IFormatProvider 実装です。その GetFormat メソッドは、返された文字列内の実数と虚数の形式に関するカルチャ固有の情報を提供する NumberFormatInfo オブジェクトを返します。このオブジェクトは、format パラメーターに応じて、負符号、グループ区切り記号、出力文字列の小数点記号などの記号を制御します。 provider が null場合、返される文字列は現在のカルチャの NumberFormatInfo オブジェクトを使用して書式設定されます。

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

書式設定情報を提供するカルチャを表す CultureInfo オブジェクト
書式設定情報を提供する NumberFormatInfo オブジェクト。
IFormatProvider インターフェイスを実装するカスタムオブジェクト。その GetFormat メソッドは、書式設定情報を提供する NumberFormatInfo オブジェクトを返します。

こちらもご覧ください

標準の数値書式指定文字列をする
カスタム数値書式指定文字列をする

適用対象

ToString(String)

ソース:: Complex.cs

ソース:: Complex.cs

ソース:: Complex.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

パラメーター

format: String

標準またはカスタムの数値書式指定文字列。

戻り値

String

デカルト形式の現在のインスタンスの文字列形式。

例外

FormatException

format は有効な書式指定文字列ではありません。

例

次の例では、複素数を初期化し、いくつかの標準書式指定文字列を使用して表示します。

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      string[] formats = { "F2", "N2", "G5" };

      foreach (Complex c1 in c)
      {
         foreach (string format in formats)
            Console.WriteLine("{0}: {1}    ", format, c1.ToString(format));

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       F2: (17.30, 14.10)
//       N2: (17.30, 14.10)
//       G5: (17.3, 14.1)
//
//       F2: (-18.90, 147.20)
//       N2: (-18.90, 147.20)
//       G5: (-18.9, 147.2)
//
//       F2: (13.47, -18.12)
//       N2: (13.47, -18.12)
//       G5: (13.472, -18.115)
//
//       F2: (-11.15, -17.00)
//       N2: (-11.15, -17.00)
//       G5: (-11.154, -17.002)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let formats = [ "F2"; "N2"; "G5" ]

for c1 in c do
    for format in formats do
        printf $"{format}: {c1.ToString(format)}    "

    printfn ""
// The example displays the following output:
//       F2: (17.30, 14.10)
//       N2: (17.30, 14.10)
//       G5: (17.3, 14.1)
//
//       F2: (-18.90, 147.20)
//       N2: (-18.90, 147.20)
//       G5: (-18.9, 147.2)
//
//       F2: (13.47, -18.12)
//       N2: (13.47, -18.12)
//       G5: (13.472, -18.115)
//
//       F2: (-11.15, -17.00)
//       N2: (-11.15, -17.00)
//       G5: (-11.154, -17.002)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim formats() As String = { "F2", "N2", "G5" } 
      
      For Each c1 As Complex In c
         For Each format As String In formats
            Console.WriteLine("{0}: {1}    ", format, c1.ToString(format))
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'       F2: (17.30, 14.10)
'       N2: (17.30, 14.10)
'       G5: (17.3, 14.1)
'       
'       F2: (-18.90, 147.20)
'       N2: (-18.90, 147.20)
'       G5: (-18.9, 147.2)
'       
'       F2: (13.47, -18.12)
'       N2: (13.47, -18.12)
'       G5: (13.472, -18.115)
'       
'       F2: (-11.15, -17.00)
'       N2: (-11.15, -17.00)
'       G5: (-11.154, -17.002)

注釈

.NET では、次の記事で詳しく説明されている広範な書式設定のサポートが提供されています。

数値書式指定文字列の詳細については、「標準の数値書式指定文字列のとカスタム数値書式指定文字列」を参照してください。
.NET での書式設定の詳細については、「書式設定の種類を参照してください。

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

こちらもご覧ください

標準の数値書式指定文字列をする
カスタム数値書式指定文字列をする

適用対象

ToString(IFormatProvider)

ソース:: Complex.cs

ソース:: Complex.cs

ソース:: Complex.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

パラメーター

provider: IFormatProvider

カルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

String

providerで指定されたデカルト形式の現在のインスタンスの文字列形式。

例

次の例では、複数の複素数の文字列形式を表示します。結果では、英語 - 米国 ("en-US") とフランス - フランス ("fr-FR") カルチャの書式設定規則が使用されます。

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      CultureInfo[] cultures = { new CultureInfo("en-US"),
                                 new CultureInfo("fr-FR") };
      foreach (Complex c1 in c)
      {
         foreach (CultureInfo culture in cultures)
            Console.Write("{0} ({1})    ", c1.ToString(culture), culture.Name);

         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

open System.Globalization
open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

let cultures = [ CultureInfo "en-US"; CultureInfo "fr-FR" ]

for c1 in c do
    for culture in cultures do
        printf $"{c1.ToString culture} ({culture.Name})"

    printfn ""
// The example displays the following output:
//       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
//       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
//       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
//       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      Dim cultures() As CultureInfo = { New CultureInfo("en-US"), 
                                        New CultureInfo("fr-FR") } 
      For Each c1 As Complex In c
         For Each culture As CultureInfo In cultures
            Console.Write("{0} ({1})    ", c1.ToString(culture), culture.Name)
         Next
         Console.WriteLine()
      Next                          
   End Sub
End Module
' The example displays the following output:
'       (17.3, 14.1) (en-US)    (17,3, 14,1) (fr-FR)
'       (-18.9, 147.2) (en-US)    (-18,9, 147,2) (fr-FR)
'       (13.472, -18.115) (en-US)    (13,472, -18,115) (fr-FR)
'       (-11.154, -17.002) (en-US)    (-11,154, -17,002) (fr-FR)

注釈

このメソッドによって返される複素数の文字列表現は、フォーム (または .NET 7 以前のバージョンでは ) のデカルト座標を使用して数値を表示します。ここで、は複素数の実際の部分であり、b はその虚数部分です。と b 両方とも、一般的な書式指定子 ("G") と、で定義されたカルチャの規則を使用して書式設定されます。

provider パラメーターは、IFormatProvider 実装です。その GetFormat メソッドは、返された文字列内の実数と虚数の形式に関するカルチャ固有の情報を提供する NumberFormatInfo オブジェクトを返します。 provider が null場合、返される文字列は現在のカルチャの NumberFormatInfo オブジェクトを使用して書式設定されます。

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

書式設定情報を提供するカルチャを表す CultureInfo オブジェクト
書式設定情報を提供する NumberFormatInfo オブジェクト。
IFormatProvider インターフェイスを実装するカスタムオブジェクト。その GetFormat メソッドは、書式設定情報を提供する NumberFormatInfo オブジェクトを返します。

適用対象

ToString()

ソース:: Complex.cs

ソース:: Complex.cs

ソース:: Complex.cs

現在の複素数の値を、デカルト形式の等価の文字列形式に変換します。

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

戻り値

String

デカルト形式の現在のインスタンスの文字列形式。

例

次の例では、複数の複素数の文字列形式を表示します。出力では、英語 - 米国 ("en-US") カルチャの書式設定規則が使用されます。この場合は、現在のシステムカルチャです。

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      Complex[] c = { new Complex(17.3, 14.1),
                      new Complex(-18.9, 147.2),
                      new Complex(13.472, -18.115),
                      new Complex(-11.154, -17.002) };
      foreach (Complex c1 in c)
         Console.WriteLine(c1.ToString());
   }
}
// The example display the following output:
//       (17.3, 14.1)
//       (-18.9, 147.2)
//       (13.472, -18.115)
//       (-11.154, -17.002)

open System.Numerics

let c =
    [ Complex(17.3, 14.1)
      Complex(-18.9, 147.2)
      Complex(13.472, -18.115)
      Complex(-11.154, -17.002) ]

for c1 in c do
    printfn $"{c1.ToString()}"
// The example display the following output:
//       (17.3, 14.1)
//       (-18.9, 147.2)
//       (13.472, -18.115)
//       (-11.154, -17.002)

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim c() As Complex = { New Complex(17.3, 14.1), 
                             New Complex(-18.9, 147.2), 
                             New Complex(13.472, -18.115), 
                             New Complex(-11.154, -17.002) }
      For Each c1 As Complex In c
         Console.WriteLine(c1.ToString())
      Next                          
   End Sub
End Module
' The example displays the following output:
'       (17.3, 14.1)
'       (-18.9, 147.2)
'       (13.472, -18.115)
'       (-11.154, -17.002)

注釈

複素数の既定の文字列表現では、フォーム (または .NET 7 以前のバージョンでは ) のデカルト座標を使用して数値が表示されます。ここで、は複素数の実数部分であり、b はその虚数部分です。 b はどちらも、一般的な書式指定子 ("G") と現在のシステムカルチャの規則を使用して書式設定されます。

適用対象

次の方法で共有

Complex.ToString メソッド

定義

オーバーロード

ToString(String, IFormatProvider)

パラメーター

戻り値

実装

例外

例

注釈

こちらもご覧ください

適用対象

ToString(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ToString(IFormatProvider)

パラメーター

戻り値

例

注釈

適用対象

ToString()

戻り値

例

注釈

適用対象

その他のリソース