Complex.Equals Método

Definição

Espaço de Nomes:

System.Numerics

Assemblagens:

netstandard.dll, System.Runtime.Numerics.dll

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

Sobrecargas

Name	Description
Equals(Object)	Devolve um valor que indica se a instância atual e um objeto especificado têm o mesmo valor.
Equals(Complex)	Devolve 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

Devolve 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 comparar.

Devoluções

Boolean

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

Observações

Dois números complexos são iguais se as suas partes reais forem iguais e as 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);

this.Real.Equals((value :?> Complex).Real)
&& this.Imaginary.Equals((value :?> Complex).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 dado para o qual está definida uma conversão implícita, o Equals(Object) método converte-se obj num Complex objeto cuja parte real é igual ao valor de obj e cuja parte imaginária é igual a zero antes de realizar a comparação. O exemplo seguinte ilustra isto ao constatar que um número complexo e um valor de ponto flutuante de dupla precisão 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.

let n1 = 16.33;
let c1 = System.Numerics.Complex(16.33, 0)
printfn $"{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 para Chamadores

Use o Equals(Complex) método com cautela, pois dois valores aparentemente equivalentes podem ser considerados desiguais devido à precisão diferente dos seus componentes reais e imaginários. O problema pode ser acentuado se obj for necessário converter para a Double antes de realizar a comparação. O exemplo seguinte compara um número complexo cujo componente real parece ser igual a um Single valor com esse Single valor. Como o resultado mostra, a comparação para igualdade devolve 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

open System.Numerics

let n1 = 1.430718e-12f
let c1 = Complex(1.430718e-12, 0);
printfn $"{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 de diferença aceitável entre os dois valores (como 0,01% de um dos componentes real e imaginário dos valores) em vez de comparar os valores para igualdade. Se o valor absoluto da diferença entre os dois valores for menor ou igual a essa margem, a diferença provavelmente se deve a uma diferença de precisão e, portanto, os valores são provavelmente iguais. O exemplo seguinte utiliza esta técnica para comparar os dois valores que o exemplo de código anterior considerou desiguais. Agora considera-os 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

open System.Numerics

let n1 = 1.430718e-12f
let c1 = Complex(1.430718e-12, 0);
let difference = 0.0001f;

// Compare the values
let result = (abs (c1.Real - float n1) <= c1.Real * float difference) && c1.Imaginary = 0;
printfn $"{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

Devolve 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 para comparar.

Devoluções

Boolean

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

Implementações

Equals(T)

Observações

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

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

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

this.Real.Equals value && this.Imaginary.Equals value

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

Notas para Chamadores

Use o Equals(Complex) método com cautela, pois dois valores aparentemente equivalentes podem ser considerados desiguais devido à precisão diferente dos seus componentes reais e imaginários. O exemplo seguinte indica 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

    let c1 = System.Numerics.Complex(3.33333, 0.142857)
    let c2 = System.Numerics.Complex(10. / 3., 1. / 7.)
    printfn $"{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 de diferença aceitável entre os dois valores (como 0,01% de um dos componentes real e imaginário dos valores) em vez de comparar os valores para igualdade. Se o valor absoluto da diferença entre os dois valores for menor ou igual a essa margem, a diferença provavelmente se deve a uma diferença de precisão e, portanto, os valores tendem a ser iguais. O exemplo seguinte utiliza esta técnica para comparar os dois valores complexos que o exemplo de código anterior considerou desiguais. Considera que os dois números complexos 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);
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

    let c1 = System.Numerics.Complex(3.33333, 0.142857)
    let c2 = System.Numerics.Complex(10. / 3., 1. / 7.)
    let difference = 0.0001

    // Compare the values
    let result =
        (Math.Abs(c1.Real - c2.Real) <= c1.Real * difference)
        && (Math.Abs(c1.Imaginary - c2.Imaginary) <= c1.Imaginary * difference)

    printfn $"{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

Ver também

• Double