Complex.Equals Método

Definição

Namespace:

System.Numerics

Assembly:

System.Runtime.Numerics.dll

Retorna um valor que indica se dois números complexos são iguais.

Sobrecargas

Equals(Object)	Retorna um valor que indica se a instância atual e um objeto especificado têm o mesmo valor.
Equals(Complex)	Retorna um valor que indica se a instância atual e um número complexo especificado têm o mesmo valor.

Equals(Object)

Origem:

Complex.cs

Retorna um valor que indica se a instância atual e um objeto especificado têm o mesmo valor.

public:
 override bool Equals(System::Object ^ obj);

public override bool Equals (object? obj);

override this.Equals : obj -> bool

Public Overrides Function Equals (obj As Object) As Boolean

Parâmetros

obj

Object

O objeto a ser comparado.

Retornos

Boolean

true se o parâmetro obj for um objeto Complex ou um tipo capaz de conversão implícita para um objeto Complex e seu valor for igual ao objeto Complex atual; caso contrário, false.

Comentários

Dois números complexos são iguais se suas partes reais forem iguais e suas partes imaginárias forem iguais. O Equals(Object) método é equivalente à seguinte expressão:

return this.Real.Equals(((Complex) value).Real) &&
       this.Imaginary.Equals(((Complex) value).Imaginary);

Return Me.Real.Equals(CType(value, Complex).Real) AndAlso 
       Me.Imaginary.Equals(CType(value, Complex).Imaginary)

Se o obj parâmetro não for um Complex objeto , mas for um tipo de dados para o qual uma conversão implícita é definida, o Equals(Object) método será convertido obj em um Complex objeto cuja parte real é igual ao valor de obj e cuja parte imaginária é igual a zero antes de executar a comparação. O exemplo a seguir ilustra isso descobrindo que um número complexo e um valor de ponto flutuante de precisão dupla são iguais.

double n1 = 16.33;
System.Numerics.Complex c1 =
       new System.Numerics.Complex(16.33, 0);
Console.WriteLine(c1.Equals(n1));               // Returns true.

Dim n1 As Double = 16.33
Dim c1 As New System.Numerics.Complex(16.33, 0)
Console.WriteLine(c1.Equals(n1))                ' Returns True.

Notas aos Chamadores

Use o Equals(Complex) método com cuidado, pois dois valores aparentemente equivalentes podem ser considerados desiguais devido à precisão diferente de seus componentes reais e imaginários. O problema poderá ser acentuado se obj precisar ser convertido em um Double antes de executar a comparação. O exemplo a seguir compara um número complexo cujo componente real parece ser igual a um Single valor com esse Single valor. Como mostra a saída, a comparação de igualdade retorna False.

using System;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      float n1 = 1.430718e-12f;
      Complex c1 = new Complex(1.430718e-12, 0);
      Console.WriteLine("{0} = {1}: {2}", c1, n1, c1.Equals(n1));
   }
}
// The example displays the following output:
//       (1.430718E-12, 0) = 1.430718E-12: False

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim n1 As Single = 1.430718e-12
      Dim c1 As New Complex(1.430718e-12, 0)
      Console.WriteLine("{0} = {1}: {2}", c1, n1, c1.Equals(n1))
   End Sub
End Module
' The example displays the following output:
'       (1.430718E-12, 0) = 1.430718E-12: False

Uma técnica recomendada é definir uma margem aceitável de diferença entre os dois valores (como 0,01% de um dos componentes reais e imaginários dos valores) em vez de comparar os valores quanto à igualdade. Se o valor absoluto da diferença entre os dois valores for menor ou igual a essa margem, é provável que a diferença seja devido a uma diferença de precisão e, portanto, os valores provavelmente serão iguais. O exemplo a seguir usa essa técnica para comparar os dois valores que o exemplo de código anterior considerou diferentes. Agora acha que eles são iguais.

using System.Numerics;

public class Example
{
   public static void Main()
   {
      float n1 = 1.430718e-12f;
      Complex c1 = new Complex(1.430718e-12, 0);
      double difference = .0001;

      // Compare the values
      bool result = (Math.Abs(c1.Real - n1) <= c1.Real * difference) &
                    c1.Imaginary == 0;
      Console.WriteLine("{0} = {1}: {2}", c1, n1, result);
   }
}
// The example displays the following output:
//       (1.430718E-12, 0) = 1.430718E-12: True

Imports System.Numerics

Module Example
   Public Sub Main()
      Dim n1 As Single = 1.430718e-12
      Dim c1 As New Complex(1.430718e-12, 0)
      Dim difference As Double = .0001
      
      ' Compare the values
      Dim result As Boolean = (Math.Abs(c1.Real - n1) <= c1.Real * difference) And
                              c1.Imaginary = 0
      Console.WriteLine("{0} = {1}: {2}", c1, n1, result)       
   End Sub
End Module
' The example displays the following output:
'       (1.430718E-12, 0) = 1.430718E-12: True

Equals(Complex)

Origem:

Complex.cs

Retorna um valor que indica se a instância atual e um número complexo especificado têm o mesmo valor.

public:
 virtual bool Equals(System::Numerics::Complex value);

public bool Equals (System.Numerics.Complex value);

override this.Equals : System.Numerics.Complex -> bool

Public Function Equals (value As Complex) As Boolean

Parâmetros

value

Complex

O número complexo a comparar.

Retornos

Boolean

true se este número complexo value tiverem o mesmo valor; caso contrário, false.

Implementações

Equals(T)

Comentários

O Equals(Complex) método fornece a IEquatable<T> implementação para a Complex estrutura . Ele tem um desempenho um pouco melhor do que o Equals(Object) método porque não precisa converter seu parâmetro em um número complexo.

Dois números complexos são iguais se suas partes reais forem iguais e suas partes imaginárias forem iguais. O Equals(Complex) método é equivalente à seguinte expressão:

return this.Real.Equals(value) && this.Imaginary.Equals(value);

Return Me.Real.Equals(value.Real) AndAlso Me.Imaginary.Equals(value.Imaginary)

Notas aos Chamadores

Use o Equals(Complex) método com cuidado, pois dois valores aparentemente equivalentes podem ser considerados desiguais devido à precisão diferente de seus componentes reais e imaginários. O exemplo a seguir relata que (3.33333, 0.142857) e (10/3, 1/7) não são iguais.

System.Numerics.Complex c1 = new System.Numerics.Complex(3.33333, .142857);
System.Numerics.Complex c2 = new System.Numerics.Complex(10/3.0, 1.0/7);
Console.WriteLine("{0} = {1}: {2}", c1, c2, c1.Equals(c2));
// The example displays the following output:
//    (3.33333, 0.142857) = (3.33333333333333, 0.142857142857143): False

Dim c1 As New System.Numerics.Complex(3.33333, .142857)
Dim c2 As New System.Numerics.Complex(10/3, 1/7)
Console.WriteLine("{0} = {1}: {2}", c1, c2, c1.Equals(c2))       
' The example displays the following output:
'    (3.33333, 0.142857) = (3.33333333333333, 0.142857142857143): False

Uma técnica recomendada é definir uma margem aceitável de diferença entre os dois valores (como 0,01% de um dos componentes reais e imaginários dos valores) em vez de comparar os valores quanto à igualdade. Se o valor absoluto da diferença entre os dois valores for menor ou igual a essa margem, é provável que a diferença seja devido a uma diferença de precisão e, portanto, os valores provavelmente serão iguais. O exemplo a seguir usa essa técnica para comparar os dois valores complexos que o exemplo de código anterior considerou diferentes. Ele considera os dois números complexos iguais.

System.Numerics.Complex c1 = new System.Numerics.Complex(3.33333, .142857);
System.Numerics.Complex c2 = new System.Numerics.Complex(10/3.0, 1.0/7);
double difference = .0001;

// Compare the values
bool result = (Math.Abs(c1.Real - c2.Real) <= c1.Real * difference) &
              (Math.Abs(c1.Imaginary - c2.Imaginary) <= c1.Imaginary * difference);
Console.WriteLine("{0} = {1}: {2}", c1, c2, result);
// The example displays the following output:
//    (3.33333, 0.142857) = (3.33333333333333, 0.142857142857143): True

Dim c1 As New System.Numerics.Complex(3.33333, .142857)
Dim c2 As New System.Numerics.Complex(10/3.0, 1.0/7)
Dim difference As Double = .0001

' Compare the values
Dim result As Boolean = (Math.Abs(c1.Real - c2.Real) <= c1.Real * difference) And
                        (Math.Abs(c1.Imaginary - c2.Imaginary) <= c1.Imaginary * difference)
Console.WriteLine("{0} = {1}: {2}", c1, c2, result)       
' The example displays the following output:
'    (3.33333, 0.142857) = (3.33333333333333, 0.142857142857143): True

Confira também

• Double