Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

HashCode.Combine – kombinování hodnot do hash kódu

HashCode.Combine vytváří hash kód typu int z jedné až osmi hodnot. Hodí se v metodě GetHashCode pro typy s rovností založenou na polích, ale výsledek není trvalý identifikátor ani důkaz rovnosti.

Verze: .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 je statická metoda typu System.HashCode, dostupná v .NET 10. Její přetížení přijímají jednu až osm hodnot a vracejí int. Zobrazená syntaxe se týká dvou hodnot; kompilátor obvykle odvodí argumenty typů. Jednoargumentové přetížení zlepšuje rozložení hash kódu hodnoty.

V implementaci GetHashCode zahrňte pole v souladu s pravidly metody Equals. Shodné objekty musí mít shodné hash kódy; shodné hash kódy ale rovnost nedokazují, protože může dojít ke kolizím. V příkladu GridPoint porovnává X a Y a HashCode.Combine(X, Y) používá tatáž pole v pevném pořadí.

Výsledek neukládejte jako trvalý identifikátor ani ho neporovnávejte mezi spuštěními. HashCode používá náhodné počáteční číslo pro proces a jeho implementace se může mezi verzemi měnit. Příklad proto vypisuje výsledky porovnání, nikoli číselnou hodnotu hash kódu.

Pro více než osm hodnot použijte instanci HashCode, opakovaná volání Add a nakonec ToHashCode. Add má také přetížení, které přijímá vlastní porovnávač; hodí se, když musí hashování odpovídat vlastním pravidlům rovnosti.

Pří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ýsledek

True
True

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje