Complex.ToString メソッド

定義

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

オーバーロード

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

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

戻り値

format および provider が指定する現在のインスタンスのデカルト形式の文字列形式。

実装

例外

format は有効な文字列ではありません。

次の例では、複素数の配列を作成し、複数の標準書式指定文字列CultureInfoと、英語 - 米国 ("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") };
      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)
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)

注釈

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

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

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

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

戻り値

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

例外

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)
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)

注釈

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

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

返される文字列の形式は、現在のカルチャの 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

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

戻り値

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)
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)

注釈

このメソッドによって返される複素数の文字列表現は、ab)の形式,(でデカルト座標を使用して数値を表示します。ここで、 a は複素数の実際の部分、b はその虚数部分です。 ab はどちらも、一般的な書式指定子 ("G") と でprovider定義されたカルチャの規則を使用して書式設定されます。

パラメーターは provider 実装です IFormatProvider 。 そのメソッドは GetFormatNumberFormatInfo 返された文字列内の実数と虚数の形式に関するカルチャ固有の情報を提供する オブジェクトを返します。 が nullの場合provider、返される文字列は現在のカルチャの オブジェクトを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

戻り値

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

次の例では、複数の複素数の文字列表現を表示します。 出力では、英語 - 米国 ("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)
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)

注釈

複素数の既定の文字列表現は、ab)の形式,(でデカルト座標を使用して数値を表示します。ここで、 a は複素数の実数部分、b は虚数部分です。 ab はどちらも、一般的な書式指定子 ("G") と現在のシステム カルチャの規則を使用して書式設定されます。

適用対象