CKTIS / C#
HashCode.Combine — combiner des valeurs dans un code de hachage
HashCode.Combine produit un code de hachage de type int à partir d’une à huit valeurs. Cette méthode est utile dans GetHashCode pour les types dont l’égalité repose sur les champs, mais son résultat n’est ni un identifiant persistant ni une preuve d’égalité.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine est une méthode statique de System.HashCode, disponible à partir de .NET 10. Ses surcharges acceptent une à huit valeurs et renvoient un int. La syntaxe présentée concerne deux valeurs ; le compilateur déduit généralement les arguments de type. La surcharge à un argument améliore la dispersion du code de hachage d’une valeur.
Dans une implémentation de GetHashCode, tenez compte des champs conformément aux règles de Equals. Des objets égaux doivent avoir des codes de hachage égaux ; des codes identiques ne prouvent toutefois pas l’égalité, car des collisions sont possibles. Dans l’exemple, GridPoint compare X et Y, et HashCode.Combine(X, Y) utilise ces mêmes champs dans un ordre fixe.
Ne stockez pas le résultat comme identifiant persistant et ne le comparez pas entre plusieurs exécutions. HashCode utilise une graine aléatoire propre au processus, et son implémentation peut changer d’une version à l’autre. L’exemple affiche donc les résultats des comparaisons plutôt qu’un code de hachage numérique.
Pour plus de huit valeurs, utilisez une instance de HashCode, des appels successifs à Add, puis un appel final à ToHashCode. Add possède également une surcharge qui accepte un comparateur personnalisé, utile lorsque le hachage doit respecter des règles d’égalité personnalisées.
Exemples
using System;
var first = new GridPoint(3, 7);
var second = new GridPoint(3, 7);
Console.WriteLine(first.Equals(second));
Console.WriteLine(first.GetHashCode() == second.GetHashCode());
readonly struct GridPoint
{
public GridPoint(int x, int y)
{
X = x;
Y = y;
}
public int X { get; }
public int Y { get; }
public override bool Equals(object? obj) =>
obj is GridPoint other && X == other.X && Y == other.Y;
public override int GetHashCode() => HashCode.Combine(X, Y);
}Résultat
True True
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.