CKTIS / C#
HashCode.Combine — комбиниране на стойности в хеш код
HashCode.Combine създава хеш код от тип int въз основа на една до осем стойности. Полезен е в GetHashCode за типове с равенство, основано на полета, но резултатът не е постоянен идентификатор и не доказва равенство.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine е статичен метод на System.HashCode, наличен в .NET 10. Неговите претоварвания приемат от една до осем стойности и връщат int. Показаният синтаксис се отнася за две стойности; компилаторът обикновено извежда аргументите на типовете. Претоварването с един аргумент подобрява разпределението на хеш кода на стойност.
В реализация на GetHashCode включвайте полетата в съответствие с правилата на Equals. Равните обекти трябва да имат равни хеш кодове; еднаквите хеш кодове обаче не доказват равенство, тъй като са възможни колизии. В примера GridPoint сравнява X и Y, а HashCode.Combine(X, Y) използва същите полета във фиксиран ред.
Не съхранявайте резултата като постоянен идентификатор и не го сравнявайте между стартирания. HashCode използва случайно начално семе за процеса, а реализацията му може да се променя между версиите. Затова примерът извежда резултатите от сравненията, а не числова стойност на хеш код.
За повече от осем стойности използвайте екземпляр на HashCode, последователни извиквания на Add и накрая ToHashCode. Add има и претоварване, което приема потребителски компаратор; то е полезно, когато хеширането трябва да съответства на потребителски правила за равенство.
Примери
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);
}Резултат
True True
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.