CKTIS / C#
System.IEquatable<T> — égalité fortement typée
System.IEquatable<T> définit Equals(T), une comparaison d’égalité avec un argument fortement typé. Une implémentation cohérente couvre également Equals(object), GetHashCode() et les opérateurs == et !=, afin qu’un type personnalisé se comporte de façon prévisible dans les collections.
Version : .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> permet de définir l’égalité pour un type précis ; généralement, T est le type qui implémente l’interface, comme dans ItemId : IEquatable<ItemId>. Sa méthode Equals(T) renvoie true lorsque les valeurs sont égales selon la règle choisie. Elle ne définit pas l’ordre de tri — c’est le rôle de IComparable<T>. L’interface est disponible dans .NET 10 ; l’exemple ne nécessite aucune fonctionnalité en préversion.
Equals(T) doit être réflexive, symétrique et transitive, et fournir des résultats cohérents tant que les données ne changent pas. Pour une classe, la comparaison avec null doit renvoyer false. Redéfinissez également Equals(object) et GetHashCode() en veillant à leur cohérence avec l’égalité fortement typée. L’interface ne définit pas elle-même les opérateurs == et != ; si vous les fournissez, ils doivent suivre la même règle.
EqualityComparer<T>.Default utilise IEquatable<T> lorsque le type l’implémente. Les collections génériques peuvent ainsi recourir à l’égalité fortement typée et éviter le boxing des structures lors de cette comparaison. Un comparateur personnalisé fourni à une collection peut appliquer une autre règle. Convertir explicitement une structure en object entraîne toujours un boxing, comme dans le deuxième appel de l’exemple.
Des valeurs égales doivent renvoyer des résultats identiques avec GetHashCode(), mais des empreintes identiques ne prouvent pas l’égalité. Ne modifiez pas les données qui déterminent l’égalité ou l’empreinte tant qu’un objet sert de clé dans Dictionary<TKey,TValue> ou d’élément dans HashSet<T>. L’exemple utilise une structure immuable : deux identifiants dont Value vaut 42 sont égaux, donc HashSet<ItemId> rejette le doublon.
Exemples
#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);
}
}Résultat
True True True True False 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.