CKTIS / C#
System.IEquatable<T> — typovo bezpečná rovnosť
System.IEquatable<T> definuje Equals(T), porovnanie rovnosti s argumentom konkrétneho typu. Konzistentná implementácia zahŕňa aj Equals(object), GetHashCode() a operátory == a !=, aby sa vlastný typ v kolekciách správal predvídateľne.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
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> umožňuje definovať rovnosť pre konkrétny typ; T je zvyčajne typ, ktorý rozhranie implementuje, napríklad ItemId : IEquatable<ItemId>. Metóda Equals(T) vracia true, keď sú hodnoty podľa zvoleného pravidla rovnaké. Nedefinuje poradie triedenia — to je úlohou IComparable<T>. Rozhranie je dostupné v .NET 10; príklad nevyžaduje funkcie vo verzii preview.
Equals(T) by mala byť reflexívna, symetrická a tranzitívna a pri nezmenených údajoch vracať konzistentné výsledky. Pri triede by porovnanie s null malo vrátiť false. Prepíšte aj Equals(object) a GetHashCode() tak, aby boli v súlade s typovanou rovnosťou. Rozhranie samo nedefinuje operátory == a !=; ak ich poskytujete, musia sa riadiť rovnakým pravidlom.
EqualityComparer<T>.Default používa IEquatable<T>, keď typ toto rozhranie implementuje. Generické kolekcie tak môžu používať typovanú rovnosť a pri tomto porovnaní sa vyhnúť boxingu štruktúr. Vlastný comparer odovzdaný kolekcii môže uplatniť iné pravidlo. Explicitné pretypovanie štruktúry na object stále spôsobí boxing, ako ukazuje druhé volanie v príklade.
Rovnaké hodnoty musia vracať rovnaké výsledky GetHashCode(), ale rovnaké hashe nedokazujú rovnosť. Nemeňte údaje, ktoré určujú rovnosť alebo hash, keď je objekt kľúčom v Dictionary<TKey,TValue> alebo prvkom v HashSet<T>. Príklad používa nemennú štruktúru: dva identifikátory, ktorých Value je 42, sú rovnaké, takže HashSet<ItemId> duplikát odmietne.
Príklady
#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);
}
}Výsledok
True True True True False 1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.