CKTIS / C#
System.IEquatable<T> — tipizirana jednakost
System.IEquatable<T> definira Equals(T), usporedbu jednakosti s argumentom određenog tipa. Dosljedna implementacija obuhvaća i Equals(object), GetHashCode() te operatore == i !=, kako bi se prilagođeni tip predvidljivo ponašao u kolekcijama.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
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> omogućuje definiranje jednakosti za određeni tip; obično je T tip koji implementira sučelje, primjerice ItemId : IEquatable<ItemId>. Metoda Equals(T) vraća true kada su vrijednosti jednake prema odabranom pravilu. Ne definira redoslijed sortiranja — za to služi IComparable<T>. Sučelje je dostupno u .NET 10; primjer ne zahtijeva funkcionalnosti preview.
Equals(T) treba biti refleksivna, simetrična i tranzitivna te davati dosljedne rezultate dok se podaci ne mijenjaju. Kod klase usporedba s null treba vratiti false. Nadjačajte i Equals(object) i GetHashCode() te ih uskladite s tipiziranom jednakošću. Sučelje samo ne definira operatore == i !=; ako ih omogućite, moraju slijediti isto pravilo.
EqualityComparer<T>.Default koristi IEquatable<T> kada ga tip implementira. Tako generičke kolekcije mogu koristiti tipiziranu jednakost i izbjeći boxing struktura tijekom te usporedbe. Vlastiti comparer proslijeđen kolekciji može primijeniti drugo pravilo. Eksplicitno pretvaranje strukture u object i dalje uzrokuje boxing, kao u drugom pozivu primjera.
Jednake vrijednosti moraju davati jednake rezultate metode GetHashCode(), ali jednaki hashovi ne dokazuju jednakost. Nemojte mijenjati podatke koji određuju jednakost ili hash dok je objekt ključ u Dictionary<TKey,TValue> ili element u HashSet<T>. Primjer koristi nepromjenjivu strukturu: dva identifikatora čiji je Value jednak 42 jednaka su, pa HashSet<ItemId> odbacuje duplikat.
Primjeri
#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);
}
}Rezultat
True True True True False 1
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.