CKTIS / C#
HashCode.Combine — combinar valores num código hash
HashCode.Combine produz um código hash do tipo int a partir de um a oito valores. É útil em GetHashCode para tipos cuja igualdade se baseia em campos, mas o resultado não é um identificador persistente nem uma prova de igualdade.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public static int Combine<T1, T2>(T1 value1, T2 value2);HashCode.Combine é um método estático de System.HashCode, disponível no .NET 10. As suas sobrecargas aceitam entre um e oito valores e devolvem um int. A sintaxe apresentada aplica-se a dois valores; normalmente, o compilador infere os argumentos de tipo. A sobrecarga com um argumento melhora a dispersão do código hash de um valor.
Numa implementação de GetHashCode, inclui os campos de acordo com as regras de Equals. Objetos iguais têm de ter códigos hash iguais; no entanto, códigos iguais não provam igualdade, pois podem ocorrer colisões. No exemplo, GridPoint compara X e Y, e HashCode.Combine(X, Y) utiliza esses mesmos campos numa ordem fixa.
Não guardes o resultado como identificador persistente nem o compares entre execuções. HashCode utiliza uma semente aleatória para o processo, e a implementação pode mudar entre versões. Por isso, o exemplo apresenta os resultados das comparações em vez de um código hash numérico.
Para mais de oito valores, utiliza uma instância de HashCode, chamadas sucessivas a Add e, por fim, ToHashCode. Add também tem uma sobrecarga que aceita um comparador personalizado, útil quando o hashing tem de corresponder a regras de igualdade personalizadas.
Exemplos
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);
}Resultado
True True
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.