Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

HashCode.Combine – kombiniranje vrijednosti u hash kod

HashCode.Combine stvara hash kod vrste int na temelju jedne do osam vrijednosti. Koristan je u metodi GetHashCode za tipove čija se jednakost temelji na poljima, ali rezultat nije trajni identifikator ni dokaz jednakosti.

Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaksa

public static int Combine<T1, T2>(T1 value1, T2 value2);

HashCode.Combine statička je metoda tipa System.HashCode, dostupna u .NET 10. Njezina preopterećenja prihvaćaju od jedne do osam vrijednosti i vraćaju int. Prikazana sintaksa odnosi se na dvije vrijednosti; prevoditelj obično zaključuje argumente tipa. Preopterećenje s jednim argumentom poboljšava raspodjelu hash koda vrijednosti.

U implementaciji metode GetHashCode uključite polja u skladu s pravilima metode Equals. Jednaki objekti moraju imati jednake hash kodove; jednaki hash kodovi ipak ne dokazuju jednakost jer su moguće kolizije. U primjeru GridPoint uspoređuje X i Y, a HashCode.Combine(X, Y) upotrebljava ista polja fiksnim redoslijedom.

Nemojte spremati rezultat kao trajni identifikator niti ga uspoređivati između pokretanja. HashCode upotrebljava nasumično početno sjeme za proces, a implementacija se može mijenjati između verzija. Zato primjer ispisuje rezultate usporedbi, a ne brojčani hash kod.

Za više od osam vrijednosti upotrijebite instancu HashCode, uzastopne pozive metode Add i na kraju ToHashCode. Add ima i preopterećenje koje prihvaća prilagođeni uspoređivač; korisno je kada hashiranje mora odgovarati prilagođenim pravilima jednakosti.

Primjeri

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

Rezultat

True
True

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori