Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

HashCode.Combine – kombinovanie hodnôt do hash kódu

HashCode.Combine vytvára hash kód typu int z jednej až ôsmich hodnôt. Hodí sa v metóde GetHashCode pre typy s rovnosťou založenou na poliach, ale výsledok nie je trvalý identifikátor ani dôkaz rovnosti.

Verzia: .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 je statická metóda typu System.HashCode, dostupná v .NET 10. Jej preťaženia prijímajú jednu až osem hodnôt a vracajú int. Zobrazená syntax sa týka dvoch hodnôt; kompilátor zvyčajne odvodí argumenty typov. Jednoargumentové preťaženie zlepšuje rozloženie hash kódu hodnoty.

V implementácii GetHashCode zahrňte polia v súlade s pravidlami metódy Equals. Rovnaké objekty musia mať rovnaké hash kódy; rovnaké hash kódy však rovnosť nedokazujú, pretože môžu nastať kolízie. V príklade GridPoint porovnáva X a Y a HashCode.Combine(X, Y) používa tie isté polia v pevnom poradí.

Výsledok neukladajte ako trvalý identifikátor ani ho neporovnávajte medzi spusteniami. HashCode používa náhodné počiatočné číslo pre proces a jeho implementácia sa môže medzi verziami meniť. Príklad preto vypisuje výsledky porovnaní, nie číselnú hodnotu hash kódu.

Pre viac než osem hodnôt použite inštanciu HashCode, opakované volania Add a napokon ToHashCode. Add má aj preťaženie, ktoré prijíma vlastný porovnávač; hodí sa, keď musí hashovanie zodpovedať vlastným pravidlám rovnosti.

Príklady

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);
}

Výsledok

True
True

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje