Complex.ToString Complex.ToString Complex.ToString Complex.ToString Method

定義

複素数の値を等価の文字列形式に変換します。Converts the value of a complex number to its equivalent string representation.

オーバーロード

ToString() ToString() ToString() ToString()

現在の複素数の値を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

指定したカルチャ固有の書式情報を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified culture-specific formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

実数部と虚数部で構成される指定した書式を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format for its real and imaginary parts.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

実数部と虚数部で構成される指定した書式およびカルチャ固有の書式情報を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format and culture-specific format information for its real and imaginary parts.

ToString() ToString() ToString() ToString()

現在の複素数の値を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

戻り値

現在のインスタンスを表すデカルト形式の文字列形式。The string representation of the current instance in Cartesian form.

次の例では、複数の複素数の文字列形式を表示します。The following example displays the string representation of several complex numbers. 出力では、English-米国 ("en-us") カルチャの書式指定規則が使用されます。この例では、現在のシステムカルチャです。The output uses the formatting conventions of the English - United States ("en-US") culture, which, in this case, is the current system culture.

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)

注釈

複素数の既定の文字列形式では(b)いう,形式でデカルト座標を使用して数値が表示されます。ここで は複素数の実数部、 bはです。その虚数部。The default string representation of a complex number displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Abは、一般書式指定子 ("G") と現在のシステムカルチャの規則を使用して書式設定されます。Both a and b are formatted using the general format specifier ("G") and the conventions of the current system culture.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

指定したカルチャ固有の書式情報を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified culture-specific formatting information.

public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

パラメーター

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

provider が指定する現在のインスタンスのデカルト形式の文字列形式。The string representation of the current instance in Cartesian form, as specified by provider.

次の例では、複数の複素数の文字列形式を表示します。The following example displays the string representation of several complex numbers. 結果では、米国英語 (米国) のカルチャおよびフランス語 ("fr-fr") のカルチャの書式指定規則が使用されます。The result uses the formatting conventions of the English - United States ("en-US") and French - France ("fr-FR") cultures.

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)

注釈

このメソッドによって返される複素数の文字列形式(では、 b)という,形式でデカルト座標を使用して数値が表示されます。ここで は複素数の実数部です。bはその虚数部です。The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Abの両方が、汎用書式指定子 ("G") とでprovider定義されたカルチャの規則を使用して書式設定されます。Both a and b are formatted using the general format specifier ("G") and the conventions of the culture defined by provider.

provider パラメーターIFormatProviderは、の実装です。The provider parameter is an IFormatProvider implementation. このメソッドは、 NumberFormatInfo返された文字列の実数と虚数の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the real and imaginary numbers in the returned string. NumberFormatInfoprovidernull場合、返される文字列は、現在のカルチャのオブジェクトを使用して書式設定されます。If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

パラメーター providerには、次のいずれかを指定できます。The provider parameter can be one of the following:

  • 書式設定情報を提供するカルチャを表すオブジェクト。CultureInfoA CultureInfo object that represents the culture that supplies formatting information

  • 書式設定情報を提供するオブジェクト。NumberFormatInfoThe NumberFormatInfo object that supplies formatting information.

  • IFormatProviderインターフェイスを実装するカスタムオブジェクト。A custom object that implements the IFormatProvider interface. このメソッドは、 NumberFormatInfo書式設定情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns the NumberFormatInfo object that supplies formatting information.

ToString(String) ToString(String) ToString(String) ToString(String)

実数部と虚数部で構成される指定した書式を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format for its real and imaginary parts.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

パラメーター

format
String String String String

標準またはカスタムの数値書式指定文字列。A standard or custom numeric format string.

戻り値

現在のインスタンスを表すデカルト形式の文字列形式。The string representation of the current instance in Cartesian form.

例外

format は有効な文字列ではありません。format is not a valid format string.

次の例では、複素数を初期化し、いくつかの標準書式指定文字列を使用して表示します。The following example initializes a complex number and displays it using several standard format strings.

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)

注釈

このメソッドによって返される複素数の文字列形式(では、 b)という,形式でデカルト座標を使用して数値が表示されます。ここで は複素数の実数部です。bはその虚数部です。The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Abの両方が、でformat指定された書式指定文字列を使用して書式設定されます。Both a and b are formatted using the format string specified by format. パラメーター formatには、任意の有効な標準の数値書式指定子、またはカスタム数値書式指定子の任意の組み合わせを指定できます。The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. format String.Empty またnullはに等しい場合、複素数の実数部と虚数部は一般書式指定子 ("G") で書式設定されます。If format is equal to String.Empty or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). formatその他の値の場合、メソッドはFormatExceptionをスローします。If format is any other value, the method throws a FormatException.

.NET Framework には、次のトピックで詳細に説明されているさまざまな書式設定がサポートされています。The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

返される文字列の形式は、現在のカルチャNumberFormatInfoのオブジェクトによって決定されます。The format of the returned string is determined by the NumberFormatInfo object for the current culture. formatパラメーターに応じて、このオブジェクトは、出力文字列内の負の符号、桁区切り記号、小数点の記号などの記号を制御します。Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. 現在のカルチャ以外のカルチャの書式設定情報を提供するにToString(String, IFormatProvider)は、オーバーロードを呼び出します。To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

こちらもご覧ください

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

実数部と虚数部で構成される指定した書式およびカルチャ固有の書式情報を使用して、現在の複素数を等価のデカルト形式の文字列形式に変換します。Converts the value of the current complex number to its equivalent string representation in Cartesian form by using the specified format and culture-specific format information for its real and imaginary parts.

public:
 virtual System::String ^ ToString(System::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 String String String

標準またはカスタムの数値書式指定文字列。A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

カルチャ固有の書式情報を提供するオブジェクト。An object that supplies culture-specific formatting information.

戻り値

format および provider が指定する現在のインスタンスのデカルト形式の文字列形式。The string representation of the current instance in Cartesian form, as specified by format and provider.

実装

例外

format は有効な文字列ではありません。format is not a valid format string.

次の例では、複素数の配列を作成し、いくつかの標準書式指定文字列CultureInfoと、英語の米国 ("en-us") カルチャおよびフランス語 ("fr-fr") カルチャを表すオブジェクトを使用して、それぞれの値を表示します。The following example creates an array of complex numbers, and displays each using several standard format strings as well as CultureInfo objects that represent the English - United States ("en-US") and French - France ("fr-FR") cultures.

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)

注釈

このメソッドによって返される複素数の文字列形式(では、 b)という,形式でデカルト座標を使用して数値が表示されます。ここで は複素数の実数部です。bはその虚数部です。The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form (a, b), where a is the real part of the complex number, and b is its imaginary part. Abの両方が、でformat指定された書式指定文字列を使用して書式設定されます。Both a and b are formatted using the format string specified by format. パラメーター formatには、任意の有効な標準の数値書式指定子、またはカスタム数値書式指定子の任意の組み合わせを指定できます。The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. format String.Empty またnullはに等しい場合、複素数の実数部と虚数部は一般書式指定子 ("G") で書式設定されます。If format is equal to String.Empty or is null, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). formatその他の値の場合、メソッドはFormatExceptionをスローします。If format is any other value, the method throws a FormatException.

.NET Framework には、次のトピックで詳細に説明されているさまざまな書式設定がサポートされています。The .NET Framework provides extensive formatting support, which is described in greater detail in the following topics:

provider パラメーターIFormatProviderは、の実装です。The provider parameter is an IFormatProvider implementation. このメソッドは、 NumberFormatInfo返された文字列の実数と虚数の書式に関するカルチャ固有の情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the real and imaginary numbers in the returned string. formatパラメーターに応じて、このオブジェクトは、出力文字列内の負の符号、桁区切り記号、小数点の記号などの記号を制御します。Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. NumberFormatInfoprovidernull場合、返される文字列は、現在のカルチャのオブジェクトを使用して書式設定されます。If provider is null, the returned string is formatted using the NumberFormatInfo object of the current culture.

パラメーター providerには、次のいずれかを指定できます。The provider parameter can be one of the following:

  • 書式設定情報を提供するカルチャを表すオブジェクト。CultureInfoA CultureInfo object that represents the culture that supplies formatting information

  • 書式設定情報を提供するオブジェクト。NumberFormatInfoThe NumberFormatInfo object that supplies formatting information.

  • IFormatProviderインターフェイスを実装するカスタムオブジェクト。A custom object that implements the IFormatProvider interface. このメソッドは、 NumberFormatInfo書式設定情報を提供するオブジェクトを返します。 GetFormatIts GetFormat method returns the NumberFormatInfo object that supplies formatting information.

こちらもご覧ください

適用対象