Complex.Equals Metoda

Reference

Definice

Obor názvů:: System.Numerics

Sestavení:: System.Runtime.Numerics.dll

Sestavení:: System.Numerics.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí hodnotu, která označuje, zda jsou dvě komplexní čísla rovna.

Přetížení

Equals(Object)	Vrátí hodnotu, která označuje, zda aktuální instance a zadaný objekt mají stejnou hodnotu.
Equals(Complex)	Vrátí hodnotu, která označuje, zda aktuální instance a zadané komplexní číslo mají stejnou hodnotu.

Equals(Object)

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Vrátí hodnotu, která označuje, zda aktuální instance a zadaný objekt mají stejnou hodnotu.

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

public override bool Equals (object obj);

public override bool Equals (object? obj);

override this.Equals : obj -> bool

Public Overrides Function Equals (obj As Object) As Boolean

Parametry

obj: Object

Objekt k porovnání

Návraty

Boolean

true obj pokud je Complex parametr objektem nebo typem schopným implicitního převodu Complex na objekt a jeho hodnota se rovná aktuálnímu Complex objektu, falsev opačném případě hodnota .

Poznámky

Dvě komplexní čísla jsou rovna, pokud jsou jejich skutečné části rovny a jejich imaginární části jsou rovny. Metoda Equals(Object) je ekvivalentní následujícímu výrazu:

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)

obj Pokud parametr není Complex objekt, ale jedná se o datový typ, pro který je definován implicitní převod, převede obj metoda na Complex objekt, Equals(Object) jehož skutečná část je rovna hodnotě obj a jehož imaginární část je rovna nule před provedením porovnání. Následující příklad to ilustruje zjištěním, že komplexní číslo a hodnota s plovoucí desetinou čárkou s dvojitou přesností jsou stejné.

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.

Poznámky pro volající

Metodu Equals(Complex) používejte opatrně, protože dvě hodnoty, které jsou zdánlivě ekvivalentní, lze považovat za nerovné z důvodu rozdílné přesnosti jejich skutečných a imaginárních komponent. Problém může být zvýrazněn, pokud obj je nutné jej před provedením porovnání převést na .Double Následující příklad porovnává komplexní číslo, jehož skutečná součást se zdá být rovna hodnotě s danou Single Single hodnotou. Jak ukazuje výstup, porovnání rovnosti vrátí Falsehodnotu .

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

Jednou z doporučených technik je definování přijatelného rozdílu mezi těmito dvěma hodnotami (například 0,01 % jedné ze skutečných a imaginárních komponent hodnot) místo porovnání hodnot z hlediska rovnosti. Pokud je absolutní hodnota rozdílu mezi těmito dvěma hodnotami menší nebo rovna okraji, je rozdíl pravděpodobně způsoben rozdílem v přesnosti, a proto jsou hodnoty pravděpodobně stejné. Následující příklad používá tuto techniku k porovnání dvou hodnot, které předchozí příklad kódu považoval za nerovné. Nyní zjistí, že jsou si rovny.

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

Platí pro

Equals(Complex)

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Zdroj:: Complex.cs

Vrátí hodnotu, která označuje, zda aktuální instance a zadané komplexní číslo mají stejnou hodnotu.

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

Parametry

value: Complex

Komplexní číslo, které se má porovnat.

Návraty

Boolean

true pokud toto komplexní číslo a value mají stejnou hodnotu, jinak hodnota false.

Implementuje

Equals(T)

Poznámky

Metoda Equals(Complex) poskytuje implementaci IEquatable<T> pro Complex strukturu. Funguje o něco lépe než Equals(Object) metoda, protože nemusí převádět svůj parametr na komplexní číslo.

Dvě komplexní čísla jsou rovna, pokud jsou jejich skutečné části rovny a jejich imaginární části jsou rovny. Metoda Equals(Complex) je ekvivalentní následujícímu výrazu:

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)

Poznámky pro volající

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

Jednou z doporučených technik je definování přijatelného rozdílu mezi těmito dvěma hodnotami (například 0,01 % jedné ze skutečných a imaginárních komponent hodnot) místo porovnání hodnot z hlediska rovnosti. Pokud je absolutní hodnota rozdílu mezi těmito dvěma hodnotami menší nebo rovna okraji, je rozdíl pravděpodobně způsoben rozdílem v přesnosti, a proto jsou hodnoty pravděpodobně stejné. Následující příklad používá tuto techniku k porovnání dvou komplexních hodnot, které předchozí příklad kódu považoval za nerovné. Zjistí, že dvě komplexní čísla jsou rovna.

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

Viz také

Double

Platí pro

Sdílet prostřednictvím

Complex.Equals Metoda

Definice

Přetížení

Equals(Object)

Parametry

Návraty

Poznámky

Poznámky pro volající

Platí pro

Equals(Complex)

Parametry

Návraty

Implementuje

Poznámky

Poznámky pro volající

Viz také

Platí pro

Další materiály