Double.Equals メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Double の 2 つのインスタンスが同じ値を表しているかどうかを示す値を返します。

オーバーロード

Equals(Double)	このインスタンスと指定した Double オブジェクトが同じ値を表しているかどうかを示す値を返します。
Equals(Object)	このインスタンスが指定されたオブジェクトに等しいかどうかを示す値を返します。

Equals(Double)

このインスタンスと指定した Double オブジェクトが同じ値を表しているかどうかを示す値を返します。

public:
 virtual bool Equals(double obj);

public bool Equals (double obj);

override this.Equals : double -> bool

Public Function Equals (obj As Double) As Boolean

パラメーター

obj: Double

このインスタンスと比較する Double オブジェクト。

戻り値

Boolean

obj がこのインスタンスと等しい場合は true。それ以外の場合は false。

実装

Equals(T)

注釈

このメソッドはインターフェイスを実装し、パラメーターをオブジェクトに変換する必要がないので、よりも少し System.IEquatable<T> Equals obj 優れたパフォーマンスを実現します。

拡大変換

プログラミング言語によっては、パラメーター型のビット数がインスタンス型よりも少ない (狭い) メソッドをコード化 Equals できる場合があります。これは、一部のプログラミング言語で、インスタンスと同じ数のビットを持つ型としてパラメーターを表す暗黙的な拡大変換を実行するために発生する可能性があります。

たとえば、インスタンス型がで、 Double パラメーターの型がであるとします Int32 。 Microsoft C# コンパイラは、パラメーターの値をオブジェクトとして表す命令を生成し、インスタンスの値とパラメーターの拡大表現を比較するメソッドを生成します Double Double.Equals(Double) 。

コンパイラが数値型の暗黙的な拡大変換を実行するかどうかを判断するには、プログラミング言語のドキュメントを参照してください。詳細については、「型変換テーブル」トピックを参照してください。

比較の有効桁数

2 つの値の有効桁数が異なって、明らかに等価な 2 つの値が等しくない可能性があるため、メソッドは注意して Equals 使用する必要があります。次の例では、値 .333333 1 を 3 で除算して返される値が等しくない Double Double と報告しています。

// Initialize two doubles with apparently identical values
double double1 = .33333;
double double2 = (double) 1/3;
// Compare them for equality
Console.WriteLine(double1.Equals(double2));    // displays false

' Initialize two doubles with apparently identical values
Dim double1 As Double = .33333
Dim double2 As Double = 1/3
' Compare them for equality
Console.WriteLine(double1.Equals(double2))    ' displays False

1 つの手法では、等値を比較するのではなく、2 つの値間の差の許容できる相対マージン (値の 1 つの .001% など) を定義する必要があります。 2 つの値の差の絶対値が、その余白以下の場合、その差は精度の違いによる可能性が高く、したがって、値が等しくなります。次の例では、この手法を使用して、前のコード例で見つかった 2 つの値である .33333 と 1/3 Double を比較します。この場合、値は等しくなります。

// Initialize two doubles with apparently identical values
double double1 = .333333;
double double2 = (double) 1/3;
// Define the tolerance for variation in their values
double difference = Math.Abs(double1 * .00001);

// Compare the values
// The output to the console indicates that the two values are equal
if (Math.Abs(double1 - double2) <= difference)
   Console.WriteLine("double1 and double2 are equal.");
else
   Console.WriteLine("double1 and double2 are unequal.");

' Initialize two doubles with apparently identical values
Dim double1 As Double = .33333
Dim double2 As Double = 1/3
' Define the tolerance for variation in their values
Dim difference As Double = Math.Abs(double1 * .00001)

' Compare the values
' The output to the console indicates that the two values are equal
If Math.Abs(double1 - double2) <= difference Then
   Console.WriteLine("double1 and double2 are equal.")
Else
   Console.WriteLine("double1 and double2 are unequal.")
End If

注意

は、範囲が 0 に近い正の値の最小式を定義します。ため、類似する 2 つの値の差の余白はより Epsilon 大きくする必要があります Epsilon 。通常は、よりも何倍も大きくなります Epsilon 。このため、値を比較して等しい値を比較する場合 Epsilon は、を Double 使用しない方が推奨されます。

2 つ目の手法では、2 つの浮動小数点数といくつかの絶対値の差を比較します。差が絶対値以下の場合、数値は等しくなります。それより大きい場合、数値は等しくない。別の方法の 1 つは、絶対値を任意に選択する方法です。ただし、許容される差の余白は値の大きさによって異なるので、これは問題 Double になります。 2 つ目の代替手段は、浮動小数点形式の設計機能を利用します。2 つの浮動小数点値の整数表現の違いは、それらを分離する浮動小数点値の数を示します。たとえば、0.0 との差は 1 です。これは、値が 0 のを使用する場合に表現可能な値が最も小 Epsilon Epsilon Double さいためです。次の例では、この手法を使用して .33333 と 1/3 を比較します。これは、前のコード例とメソッドが等しくないと判明した 2 つの値 Double Equals(Double) です。この例では、メソッドを使用して、倍精度浮動小数点値を整数表現 BitConverter.DoubleToInt64Bits に変換します。

using System;

public class Example
{
   public static void Main()
   {
      double value1 = .1 * 10;
      double value2 = 0;
      for (int ctr = 0; ctr < 10; ctr++)
         value2 += .1;

      Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2,
                        HasMinimalDifference(value1, value2, 1));
   }

   public static bool HasMinimalDifference(double value1, double value2, int units)
   {
      long lValue1 = BitConverter.DoubleToInt64Bits(value1);
      long lValue2 = BitConverter.DoubleToInt64Bits(value2);

      // If the signs are different, return false except for +0 and -0.
      if ((lValue1 >> 63) != (lValue2 >> 63))
      {
         if (value1 == value2)
            return true;

         return false;
      }

      long diff = Math.Abs(lValue1 - lValue2);

      if (diff <= (long) units)
         return true;

      return false;
   }
}
// The example displays the following output:
//        1 = 0.99999999999999989: True

Module Example
   Public Sub Main()
      Dim value1 As Double = .1 * 10
      Dim value2 As Double = 0
      For ctr As Integer =  0 To 9
         value2 += .1
      Next
               
      Console.WriteLine("{0:R} = {1:R}: {2}", value1, value2,
                        HasMinimalDifference(value1, value2, 1))
   End Sub

   Public Function HasMinimalDifference(value1 As Double, value2 As Double, units As Integer) As Boolean
      Dim lValue1 As long =  BitConverter.DoubleToInt64Bits(value1)
      Dim lValue2 As long =  BitConverter.DoubleToInt64Bits(value2)
      
      ' If the signs are different, Return False except for +0 and -0.
      If ((lValue1 >> 63) <> (lValue2 >> 63)) Then
         If value1 = value2 Then
            Return True
         End If           
         Return False
      End If

      Dim diff As Long =  Math.Abs(lValue1 - lValue2)

      If diff <= units Then
         Return True
      End If

      Return False
   End Function
End Module
' The example displays the following output:
'       1 = 0.99999999999999989: True

ドキュメントに記載されている有効桁数を超える浮動小数点数の有効桁数は、数値の実装とバージョンに固有.NET Framework。その結果、数値の内部表現の精度が変化する可能性.NET Frameworkのバージョン間で 2 つの特定の数値の比較が変更される可能性があります。

メソッドを Double.NaN 呼び出して 2 つの値が等しいかテストされた場合、 Equals メソッドはを返します true 。ただし、2 つの値が等値演算子を使用して等しいかテストされた場合、演算子 NaN はを返します false 。の値が数値 (NaN) ではないかどうかを判断する場合は、メソッドを呼び出す Double 方法 IsNaN があります。

注意 (呼び出し元)

コンパイラオーバーロードの解決は、2 つのメソッドオーバーロードの動作の明らかな違い Equals(Object) を考慮する可能性があります。引数との間の暗黙的な変換が定義され、引数がとして型指定されていない場合、コンパイラは暗黙的な変換を実行し、 obj Double Object メソッドを呼び出 Equals(Double) す可能性があります。それ以外の場合は、メソッドを呼び出します。このメソッドは、引数が値でない場合 Equals(Object) false obj は常にを返 Double します。次の例は、2 つのメソッドオーバーロードの動作の違いを示しています。 C# のとを除くすべてのプリミティブ数値型の場合、コンパイラは拡大変換を自動的に実行し、メソッドを呼び出すのに対し、2 番目の比較はメソッドを呼び出すので、を返します。 Decimal true Equals(Double) false Equals(Object)

こちらもご覧ください

適用対象

Equals(Object)

このインスタンスが指定されたオブジェクトに等しいかどうかを示す値を返します。

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

パラメーター

obj: Object

このインスタンスと比較するオブジェクト。

戻り値

Boolean

obj が Double のインスタンスで、このインスタンスの値に等しい場合は true。それ以外の場合は false。

注釈

2 つの値の有効桁数が異なって、明らかに等価な 2 つの値が等しくない可能性があるため、メソッドは注意して Equals 使用する必要があります。次の例では、1 を 3 で除算して返される Double 値 .3333 とが等 Double しくないと報告しています。

// Initialize two doubles with apparently identical values
double double1 = .33333;
object double2 = (double) 1/3;
// Compare them for equality
Console.WriteLine(double1.Equals(double2));    // displays false

' Initialize two doubles with apparently identical values
Dim double1 As Double = .33333
Dim double2 As Object = 1/3
' Compare them for equality
Console.WriteLine(double1.Equals(double2))    ' displays False

メソッドを呼び出す代わりに Equals 、オーバーロードのドキュメントを参照 Equals(Double) してください。

注意

は、範囲が 0 に近い正の値の最小式を定義します。ため、類似する 2 つの値の差の余白はより Epsilon 大きくする必要があります Epsilon 。通常は、よりも何倍も大きくなります Epsilon 。

注意 (呼び出し元)

こちらもご覧ください

CompareTo(Object)

適用対象

Double.Equals メソッド

定義

オーバーロード

Equals(Double)

パラメーター

戻り値

実装

注釈

拡大変換

比較の有効桁数

注意 (呼び出し元)

こちらもご覧ください

適用対象

Equals(Object)

パラメーター

戻り値

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

その他のリソース