IStructuralEquatable.Equals(Object, IEqualityComparer) Metoda

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

IStructuralEquatable.cs

Určuje, zda je objekt strukturálně roven aktuální instanci.

public:
 bool Equals(System::Object ^ other, System::Collections::IEqualityComparer ^ comparer);

public bool Equals(object? other, System.Collections.IEqualityComparer comparer);

abstract member Equals : obj * System.Collections.IEqualityComparer -> bool

Public Function Equals (other As Object, comparer As IEqualityComparer) As Boolean

Parametry

other

Object

Objekt, který chcete porovnat s aktuální instancí.

comparer

IEqualityComparer

Objekt, který určuje, zda aktuální instance a other jsou rovny.

Návraty

Boolean

truejsou-li dva objekty stejné; v opačném případě . false

Příklady

Výchozí porovnávač EqualityComparer<Object>.Default.Equalsrovnosti považuje dvě NaN hodnoty za rovnou. V některých případech však můžete chtít, aby porovnání NaN hodnot rovnosti vrátilo false, což znamená, že hodnoty nelze porovnat. Následující příklad definuje NanComparer třídu, která implementuje IStructuralEquatable rozhraní. Porovná dvě Double nebo dvě Single hodnoty pomocí operátoru rovnosti. Předává hodnoty jakéhokoli jiného typu do výchozího porovnávače rovnosti.

using System;
using System.Collections;
using System.Collections.Generic;

public class NanComparer : IEqualityComparer
{
   public new bool Equals(object x, object y)
   {
      if (x is float)
         return (float) x == (float) y;
      else if (x is double)
         return (double) x == (double) y;
      else
         return EqualityComparer<object>.Default.Equals(x, y);
   }

   public int GetHashCode(object obj)
   {
      return EqualityComparer<object>.Default.GetHashCode(obj);
   }
}

Imports System.Collections
Imports System.Collections.Generic

Public Class NanComparer : Implements IEqualityComparer
   Public Overloads Function Equals(x As Object, y As Object) As Boolean _
          Implements IEqualityComparer.Equals
      If TypeOf x Is Single Then
         Return CSng(x) = CSng(y)
      ElseIf TypeOf x Is Double Then
         Return CDbl(x) = CDbl(y)
      Else
         Return EqualityComparer(Of Object).Default.Equals(x, y)
      End If
   End Function
   
   Public Overloads Function GetHashCode(obj As Object) As Integer _
          Implements IEqualityComparer.GetHashCode
      Return EqualityComparer(Of Object).Default.GetHashCode(obj)
   End Function
End Class

Následující příklad vytvoří dva identické 3-řazené objekty, jejichž komponenty se skládají ze tří Double hodnot. Hodnota druhé komponenty je Double.NaN. Příklad pak volá metodu Tuple<T1,T2,T3>.Equals a volá metodu IStructuralEquatable.Equals třikrát. Poprvé předá výchozí porovnávač rovnosti vrácený EqualityComparer<T>.Default vlastností. Podruhé předá výchozí porovnávač rovnosti vrácený StructuralComparisons.StructuralEqualityComparer vlastností. Třetí čas, předá vlastní NanComparer objekt. Jak ukazuje výstup z příkladu, první tři volání metody vrátí true, zatímco čtvrté volání vrátí false.

public class Example
{
   public static void Main()
   {
      var t1 = Tuple.Create(12.3, Double.NaN, 16.4);
      var t2 = Tuple.Create(12.3, Double.NaN, 16.4);

      // Call default Equals method.
      Console.WriteLine(t1.Equals(t2));

      IStructuralEquatable equ = t1;
      // Call IStructuralEquatable.Equals using default comparer.
      Console.WriteLine(equ.Equals(t2, EqualityComparer<object>.Default));

      // Call IStructuralEquatable.Equals using
      // StructuralComparisons.StructuralEqualityComparer.
      Console.WriteLine(equ.Equals(t2,
                        StructuralComparisons.StructuralEqualityComparer));

      // Call IStructuralEquatable.Equals using custom comparer.
      Console.WriteLine(equ.Equals(t2, new NanComparer()));
   }
}
// The example displays the following output:
//       True
//       True
//       True
//       False

Module Example
   Public Sub Main()
      Dim t1 = Tuple.Create(12.3, Double.NaN, 16.4)
      Dim t2 = Tuple.Create(12.3, Double.NaN, 16.4)
      
      ' Call default Equals method.
      Console.WriteLine(t1.Equals(t2))
      
      Dim equ As IStructuralEquatable = t1
      ' Call IStructuralEquatable.Equals using default comparer.
      Console.WriteLine(equ.Equals(t2, EqualityComparer(Of Object).Default))
      
      ' Call IStructuralEquatable.Equals using 
      ' StructuralComparisons.StructuralEqualityComparer.
      Console.WriteLine(equ.Equals(t2, 
                        StructuralComparisons.StructuralEqualityComparer))
      
      ' Call IStructuralEquatable.Equals using custom comparer.
      Console.WriteLine(equ.Equals(t2, New NanComparer))
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       True
'       False

Poznámky

Metoda Equals podporuje vlastní strukturální porovnání objektů pole a řazené kolekce členů. Tato metoda zase volá metodu objektu comparerIEqualityComparer.Equals k porovnání jednotlivých prvků pole nebo komponent řazené kolekce členů, počínaje prvním prvkem nebo komponentou. Jednotlivá volání na IEqualityComparer.Equals konec a IStructuralEquatable.Equals metoda vrátí hodnotu buď při volání metody, false nebo po porovnání všech prvků pole nebo řazené součásti řazené kolekce členů.

Viz také

• StructuralEqualityComparer