CKTIS / C#
HashCode.Combine: combinare valori in un codice hash
HashCode.Combine produce un codice hash di tipo int a partire da uno a otto valori. È utile in GetHashCode per i tipi con uguaglianza basata sui campi, ma il risultato non è né un identificatore persistente né una prova di uguaglianza.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine è un metodo statico di System.HashCode, disponibile in .NET 10. I suoi overload accettano da uno a otto valori e restituiscono un int. La sintassi mostrata riguarda due valori; in genere il compilatore deduce gli argomenti di tipo. L'overload con un argomento migliora la distribuzione del codice hash di un valore.
Nell'implementazione di GetHashCode, includi i campi in modo coerente con le regole di Equals. Gli oggetti uguali devono avere codici hash uguali; codici uguali, però, non dimostrano l'uguaglianza, perché sono possibili collisioni. Nell'esempio, GridPoint confronta X e Y, e HashCode.Combine(X, Y) usa gli stessi campi in un ordine fisso.
Non salvare il risultato come identificatore persistente e non confrontarlo tra esecuzioni diverse. HashCode usa un seme casuale per il processo e la sua implementazione può cambiare tra le versioni. Perciò l'esempio stampa i risultati dei confronti, non un codice hash numerico.
Per più di otto valori, usa un'istanza di HashCode, chiamate successive a Add e infine ToHashCode. Add dispone anche di un overload che accetta un comparatore personalizzato, utile quando l'hashing deve rispettare regole di uguaglianza personalizzate.
Esempi
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);
}Risultato
True True
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.