База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници