CKTIS / C#
HashCode.Combine — waarden combineren tot een hashcode
HashCode.Combine maakt een int-hashcode op basis van één tot acht waarden. De methode is bruikbaar in GetHashCode voor typen met gelijkheid op basis van velden, maar het resultaat is geen blijvende identificatie en bewijst geen gelijkheid.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine is een statische methode van System.HashCode en is beschikbaar in .NET 10. De overloads accepteren één tot acht waarden en retourneren een int. De getoonde syntaxis betreft twee waarden; de compiler leidt de typeargumenten meestal af. De overload met één argument verbetert de spreiding van de hashcode van een waarde.
Neem in een implementatie van GetHashCode velden op volgens de regels van Equals. Gelijke objecten moeten gelijke hashcodes hebben; dezelfde hashcode bewijst echter geen gelijkheid, omdat botsingen mogelijk zijn. In het voorbeeld vergelijkt GridPoint X en Y, en gebruikt HashCode.Combine(X, Y) dezelfde velden in een vaste volgorde.
Sla het resultaat niet op als blijvende identificatie en vergelijk het niet tussen uitvoeringen. HashCode gebruikt een willekeurige seed voor het proces, en de implementatie kan tussen versies veranderen. Daarom toont het voorbeeld vergelijkingsresultaten in plaats van een numerieke hashcode.
Gebruik voor meer dan acht waarden een HashCode-instantie, opeenvolgende aanroepen van Add en tot slot ToHashCode. Add heeft ook een overload met een aangepaste comparer. Die is handig wanneer het hashen moet overeenkomen met aangepaste gelijkheidsregels.
Voorbeelden
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);
}Resultaat
True True
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.