Complex.ToString Método

Referência

Definição

Namespace:: System.Numerics

Assembly:: System.Runtime.Numerics.dll

Assembly:: System.Numerics.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Converte o valor de um número complexo em sua representação de cadeia de caracteres equivalente.

Sobrecargas

ToString(String, IFormatProvider)	Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formato Cartesiano usando o formato especificado e as informações de formato específicas da cultura para suas partes reais e imaginárias.
ToString(String)	Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formato Cartesiano usando o formato especificado para suas partes reais e imaginárias.
ToString(IFormatProvider)	Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formulário Cartesiano usando as informações de formatação específicas da cultura especificadas.
ToString()	Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formulário Cartesiano.

ToString(String, IFormatProvider)

Origem:: Complex.cs

Origem:: Complex.cs

Origem:: Complex.cs

Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formato Cartesiano usando o formato especificado e as informações de formato específicas da cultura para suas partes reais e imaginárias.

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

Parâmetros

format: String

Uma cadeia de caracteres de formato numérico padrão ou personalizado.

provider: IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

Retornos

String

A representação da cadeia de caracteres da instância atual no formulário Cartesiano, conforme especificado por format e provider.

Implementações

ToString(String, IFormatProvider)

Exceções

FormatException

format não é uma cadeia de caracteres de formato válida.

Exemplos

O exemplo a seguir cria uma matriz de números complexos e exibe cada um usando várias cadeias de caracteres de formato padrão, bem como objetos CultureInfo que representam as culturas inglês - Estados Unidos ("en-US") e francês - França ("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)

Comentários

A representação de cadeia de caracteres do número complexo retornado por esse método exibe o número usando suas coordenadas Cartesianas no formulário <a; b> (ou (a, b) no .NET 7 e versões anteriores), em que um é a parte real do número complexo e b é sua parte imaginária. Ambos um e b são formatados usando a cadeia de caracteres de formato especificada por format. O parâmetro format pode ser qualquer especificador de formato numérico padrão válido ou qualquer combinação de especificadores de formato numérico personalizado. Se format for igual a String.Empty ou for null, as partes reais e imaginárias do número complexo serão formatadas com o especificador de formato geral ("G"). Se format for qualquer outro valor, o método gerará um FormatException.

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes artigos:

Para obter mais informações sobre cadeias de caracteres de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre formatação no .NET, consulte Tipos de Formatação.

O parâmetro provider é uma implementação IFormatProvider. Seu método GetFormat retorna um objeto NumberFormatInfo que fornece informações específicas da cultura sobre o formato dos números reais e imaginários na cadeia de caracteres retornada. Dependendo do parâmetro format, esse objeto controla símbolos como o sinal negativo, o separador de grupo e o símbolo de ponto decimal na cadeia de caracteres de saída. Se provider for null, a cadeia de caracteres retornada será formatada usando o objeto NumberFormatInfo da cultura atual.

O parâmetro provider pode ser um dos seguintes:

Um objeto CultureInfo que representa a cultura que fornece informações de formatação
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa a interface IFormatProvider. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.

Confira também

cadeias de caracteres de formato numérico padrão
cadeias de caracteres de formato numérico personalizado

Aplica-se a

ToString(String)

Origem:: Complex.cs

Origem:: Complex.cs

Origem:: Complex.cs

Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formato Cartesiano usando o formato especificado para suas partes reais e imaginárias.

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

Parâmetros

format: String

Uma cadeia de caracteres de formato numérico padrão ou personalizado.

Retornos

String

A representação da cadeia de caracteres da instância atual no formulário Cartesiano.

Exceções

FormatException

format não é uma cadeia de caracteres de formato válida.

Exemplos

O exemplo a seguir inicializa um número complexo e o exibe usando várias cadeias de caracteres de formato padrão.

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)

Comentários

O .NET fornece amplo suporte à formatação, que é descrito com mais detalhes nos seguintes artigos:

Para obter mais informações sobre cadeias de caracteres de formato numérico, consulte cadeias de caracteres de formato numérico padrão e cadeias de caracteres de formato numérico personalizado.
Para obter mais informações sobre formatação no .NET, consulte Tipos de Formatação.

O formato da cadeia de caracteres retornada é determinado pelo objeto NumberFormatInfo para a cultura atual. Dependendo do parâmetro format, esse objeto controla símbolos como o sinal negativo, o separador de grupo e o símbolo de ponto decimal na cadeia de caracteres de saída. Para fornecer informações de formatação para culturas diferentes da cultura atual, chame a sobrecarga de ToString(String, IFormatProvider).

Confira também

cadeias de caracteres de formato numérico padrão
cadeias de caracteres de formato numérico personalizado

Aplica-se a

ToString(IFormatProvider)

Origem:: Complex.cs

Origem:: Complex.cs

Origem:: Complex.cs

Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formulário Cartesiano usando as informações de formatação específicas da cultura especificadas.

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

Parâmetros

provider: IFormatProvider

Um objeto que fornece informações de formatação específicas da cultura.

Retornos

String

A representação da cadeia de caracteres da instância atual no formulário Cartesiano, conforme especificado por provider.

Exemplos

O exemplo a seguir exibe a representação de cadeia de caracteres de vários números complexos. O resultado usa as convenções de formatação das culturas inglês - Estados Unidos ("en-US") e francês - França ("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)

Comentários

O parâmetro provider pode ser um dos seguintes:

Um objeto CultureInfo que representa a cultura que fornece informações de formatação
O objeto NumberFormatInfo que fornece informações de formatação.
Um objeto personalizado que implementa a interface IFormatProvider. Seu método GetFormat retorna o objeto NumberFormatInfo que fornece informações de formatação.

Aplica-se a

ToString()

Origem:: Complex.cs

Origem:: Complex.cs

Origem:: Complex.cs

Converte o valor do número complexo atual em sua representação de cadeia de caracteres equivalente no formulário Cartesiano.

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

public override string ToString ();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retornos

String

A representação da cadeia de caracteres da instância atual no formulário Cartesiano.

Exemplos

O exemplo a seguir exibe a representação de cadeia de caracteres de vários números complexos. A saída usa as convenções de formatação da cultura inglês - Estados Unidos ("en-US") que, neste caso, é a cultura atual do sistema.

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)

Comentários

A representação de cadeia de caracteres padrão de um número complexo exibe o número usando suas coordenadas Cartesianas no formulário <a; b> (ou (a, b) no .NET 7 e versões anteriores), em que um é a parte real do número complexo e b é sua parte imaginária. Ambos um e b são formatados usando o especificador de formato geral ("G") e as convenções da cultura do sistema atual.

Aplica-se a

Compartilhar via

Complex.ToString Método

Definição

Sobrecargas

ToString(String, IFormatProvider)

Parâmetros

Retornos

Implementações

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

ToString(String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

ToString(IFormatProvider)

Parâmetros

Retornos

Exemplos

Comentários

Aplica-se a

ToString()

Retornos

Exemplos

Comentários

Aplica-se a

Recursos adicionais