CKTIS / C#
System.IEquatable<T> — typově bezpečná rovnost
System.IEquatable<T> definuje Equals(T), porovnání rovnosti s argumentem konkrétního typu. Konzistentní implementace zahrnuje také Equals(object), GetHashCode() a operátory == a !=, aby se vlastní typ v kolekcích choval předvídatelně.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
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 definovat rovnost pro konkrétní typ; T je obvykle typ, který rozhraní implementuje, například ItemId : IEquatable<ItemId>. Metoda Equals(T) vrací true, pokud jsou hodnoty podle zvoleného pravidla stejné. Nedefinuje pořadí řazení — to je úlohou IComparable<T>. Rozhraní je dostupné v .NET 10; příklad nevyžaduje funkce ve verzi preview.
Equals(T) by měla být reflexivní, symetrická a tranzitivní a při nezměněných datech vracet konzistentní výsledky. U třídy by porovnání s null mělo vracet false. Přepište také Equals(object) a GetHashCode() tak, aby byly v souladu s typovanou rovností. Rozhraní samo nedefinuje operátory == a !=; pokud je poskytujete, musí se řídit stejným pravidlem.
EqualityComparer<T>.Default používá IEquatable<T>, pokud typ toto rozhraní implementuje. Generické kolekce tak mohou používat typovanou rovnost a při tomto porovnání se vyhnout boxingu struktur. Vlastní comparer předaný kolekci může použít jiné pravidlo. Explicitní převod struktury na object stále způsobuje boxing, jak ukazuje druhé volání v příkladu.
Stejné hodnoty musí vracet stejné výsledky GetHashCode(), ale shodné hashe nedokazují rovnost. Neměňte data, která určují rovnost nebo hash, když je objekt klíčem v Dictionary<TKey,TValue> nebo prvkem v HashSet<T>. Příklad používá neměnnou strukturu: dva identifikátory, jejichž Value je 42, jsou stejné, takže HashSet<ItemId> duplicitní hodnotu odmítne.
Pří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ýsledek
True True True True False 1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.