CKTIS / C#
System.IEquatable<T> — типизирано равенство
System.IEquatable<T> дефинира Equals(T) — сравнение за равенство с аргумент от конкретен тип. Последователната реализация включва също Equals(object), GetHashCode() и операторите == и !=, така че потребителският тип да се държи предвидимо в колекциите.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public readonly struct ItemId : System.IEquatable<ItemId>
{
public int Value { get; }
public ItemId(int value) => Value = value;
public bool Equals(ItemId other) => Value == other.Value;
}System.IEquatable<T> позволява да дефинирате равенство за конкретен тип; обикновено T е типът, който реализира интерфейса, както при ItemId : IEquatable<ItemId>. Методът Equals(T) връща true, когато стойностите са равни според избраното правило. Той не определя ред на сортиране — това е ролята на IComparable<T>. Интерфейсът е наличен в .NET 10; примерът не изисква функции от preview версия.
Equals(T) трябва да е рефлексивен, симетричен и транзитивен и да дава последователни резултати, докато данните не се променят. При клас сравнението с null трябва да връща false. Предефинирайте също Equals(object) и GetHashCode(), като ги съгласувате с типизираното равенство. Интерфейсът сам по себе си не дефинира операторите == и !=; ако ги предоставяте, те трябва да следват същото правило.
EqualityComparer<T>.Default използва IEquatable<T>, когато типът го реализира. Така генеричните колекции могат да използват типизирано равенство и да избегнат boxing на структури при това сравнение. Персонализиран comparer, подаден на колекция, може да приложи различно правило. Изричното преобразуване на структура към object все пак води до boxing, както при второто извикване в примера.
Равните стойности трябва да връщат еднакви резултати от GetHashCode(), но еднаквите хешове не доказват равенство. Не променяйте данните, които определят равенството или хеша, докато обектът е ключ в Dictionary<TKey,TValue> или елемент в HashSet<T>. Примерът използва неизменяема структура: два идентификатора, чиято Value е 42, са равни, затова HashSet<ItemId> отхвърля дубликата.
Примери
#nullable enable
using System;
using System.Collections.Generic;
public readonly struct ItemId : IEquatable<ItemId>
{
public int Value { get; }
public ItemId(int value) => Value = value;
public bool Equals(ItemId other) => Value == other.Value;
public override bool Equals(object? obj) =>
obj is ItemId other && Equals(other);
public override int GetHashCode() => Value;
public static bool operator ==(ItemId left, ItemId right) =>
left.Equals(right);
public static bool operator !=(ItemId left, ItemId right) =>
!left.Equals(right);
}
public static class Program
{
public static void Main()
{
var first = new ItemId(42);
var same = new ItemId(42);
var ids = new HashSet<ItemId> { first };
Console.WriteLine(first.Equals(same));
Console.WriteLine(first.Equals((object)same));
Console.WriteLine(first == same);
Console.WriteLine(ids.Contains(same));
Console.WriteLine(ids.Add(same));
Console.WriteLine(ids.Count);
}
}Резултат
True True True True False 1
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.