Complex.ToString Metoda

Definice

Obor názvů:

System.Numerics

Sestavení:

System.Runtime.Numerics.dll

Převede hodnotu komplexního čísla na ekvivalentní řetězcové vyjádření.

Přetížení

ToString(String, IFormatProvider)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi pro své skutečné a imaginární části.
ToString(String)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu pro jeho skutečné a imaginární části.
ToString(IFormatProvider)	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaných informací o formátování specifické pro jazykovou verzi.
ToString()	Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě.

ToString(String, IFormatProvider)

Zdroj:

Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu a informací o formátu specifickém pro jazykovou verzi pro své skutečné a imaginární části.

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

Parametry

format

String

Standardní nebo vlastní řetězec číselného formátu.

provider

IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální instance v kartézské podobě, jak je určeno format a provider.

Implementuje

ToString(String, IFormatProvider)

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad vytvoří pole komplexních čísel a zobrazí každou z nich pomocí několika standardních formátových řetězců a také CultureInfo objektů, které představují jazykové verze pro angličtinu – Spojené státy ("en-US") a francouzštinu – Francii ("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)

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)

Poznámky

Řetězcové vyjádření komplexního čísla vrácené touto metodou zobrazuje číslo pomocí jeho kartézských souřadnic ve formuláři (,b), kde je reálnou částí komplexního čísla a b je jeho imaginární část. i b jsou formátovány pomocí formátovacího řetězce určeného format. Parametr format může být libovolný platný specifikátor standardního číselného formátu nebo libovolnou kombinaci specifikátorů vlastního číselného formátu. Je-li format roven String.Empty nebo je null, skutečné a imaginární části komplexního čísla jsou formátovány specifikátorem obecného formátu ("G"). Pokud format je jakákoli jiná hodnota, metoda vyvolá FormatException.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech:

• Další informace o číselných formátových řetězcích naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování v rozhraní .NET Framework naleznete v tématu Typy formátování.

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace specifické pro jazykovou verzi o formátu skutečných a imaginárních čísel ve vráceném řetězci. V závislosti na parametru format tento objekt řídí symboly, jako je záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Pokud je providernull, vrácený řetězec je formátován pomocí NumberFormatInfo objektu aktuální jazykové verze.

Parametr provider může být jeden z následujících:

• Objekt CultureInfo představující jazykovou verzi, která poskytuje informace o formátování

• Objekt NumberFormatInfo, který poskytuje informace o formátování.

• Vlastní objekt, který implementuje rozhraní IFormatProvider. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace o formátování.

Viz také

• standardní řetězce číselného formátu
• vlastních řetězců číselného formátu

ToString(String)

Zdroj:

Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaného formátu pro jeho skutečné a imaginární části.

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

Parametry

format

String

Standardní nebo vlastní řetězec číselného formátu.

Návraty

String

Řetězcová reprezentace aktuální instance v kartézské podobě.

Výjimky

FormatException

format není platný formátovací řetězec.

Příklady

Následující příklad inicializuje komplexní číslo a zobrazí ho pomocí několika standardních formátových řetězců.

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)

Poznámky

Řetězcové vyjádření komplexního čísla vrácené touto metodou zobrazuje číslo pomocí jeho kartézských souřadnic ve formuláři (,b), kde je reálnou částí komplexního čísla a b je jeho imaginární část. i b jsou formátovány pomocí formátovacího řetězce určeného format. Parametr format může být libovolný platný specifikátor standardního číselného formátu nebo libovolnou kombinaci specifikátorů vlastního číselného formátu. Je-li format roven String.Empty nebo je null, skutečné a imaginární části komplexního čísla jsou formátovány specifikátorem obecného formátu ("G"). Pokud format je jakákoli jiná hodnota, metoda vyvolá FormatException.

Rozhraní .NET Framework poskytuje rozsáhlou podporu formátování, která je podrobněji popsána v následujících tématech:

• Další informace o číselných formátových řetězcích naleznete v tématu Standardní řetězce číselného formátu a vlastní řetězce číselného formátu.

• Další informace o formátování v rozhraní .NET Framework naleznete v tématu Typy formátování.

Formát vráceného řetězce je určen objektem NumberFormatInfo pro aktuální jazykovou verzi. V závislosti na parametru format tento objekt řídí symboly, jako je záporné znaménko, oddělovač skupin a symbol desetinné čárky ve výstupním řetězci. Chcete-li poskytnout informace o formátování pro jiné jazykové verze než aktuální jazyková verze, zavolejte ToString(String, IFormatProvider) přetížení.

Viz také

• standardní řetězce číselného formátu
• vlastních řetězců číselného formátu

ToString(IFormatProvider)

Zdroj:

Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě pomocí zadaných informací o formátování specifické pro jazykovou verzi.

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

public string ToString (IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Parametry

provider

IFormatProvider

Objekt, který poskytuje informace o formátování specifické pro jazykovou verzi.

Návraty

String

Řetězcové vyjádření aktuální instance v kartézské podobě, jak je určeno provider.

Příklady

Následující příklad zobrazuje řetězcovou reprezentaci několika komplexních čísel. Výsledek používá konvence formátování anglické - Spojené státy ("en-US") a francouzštiny - Francie ("fr-FR") jazykové verze.

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)

Poznámky

Řetězcové vyjádření komplexního čísla vrácené touto metodou zobrazuje číslo pomocí jeho kartézských souřadnic ve formuláři (,b), kde je reálnou částí komplexního čísla a b je jeho imaginární část. i b jsou formátovány pomocí specifikátoru obecného formátu ("G") a konvencí jazykové verze definované provider.

Parametr provider je IFormatProvider implementace. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace specifické pro jazykovou verzi o formátu skutečných a imaginárních čísel ve vráceném řetězci. Pokud je providernull, vrácený řetězec je formátován pomocí NumberFormatInfo objektu aktuální jazykové verze.

Parametr provider může být jeden z následujících:

• Objekt CultureInfo představující jazykovou verzi, která poskytuje informace o formátování

• Objekt NumberFormatInfo, který poskytuje informace o formátování.

• Vlastní objekt, který implementuje rozhraní IFormatProvider. Jeho GetFormat metoda vrátí objekt NumberFormatInfo, který poskytuje informace o formátování.

ToString()

Zdroj:

Complex.cs

Převede hodnotu aktuálního komplexního čísla na ekvivalentní řetězcové vyjádření v kartézské podobě.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Návraty

String

Řetězcová reprezentace aktuální instance v kartézské podobě.

Příklady

Následující příklad zobrazuje řetězcovou reprezentaci několika komplexních čísel. Výstup používá konvence formátování anglické - Spojené státy ("en-US") jazykové verze, což je v tomto případě aktuální systémová jazyková verze.

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)

Poznámky

Výchozí řetězcová reprezentace komplexního čísla zobrazuje číslo pomocí kartézských souřadnic ve formuláři (,b), kde je reálnou částí komplexního čísla a b je jeho imaginární částí. i b jsou formátované pomocí specifikátoru obecného formátu ("G") a konvencí aktuální jazykové verze systému.