项目管理

相等性比较

用于自定义对象相等性比较和hash码计算的机制。

// \runtime\src\libraries\System.Private.CoreLib\src\System\Collections\IEqualityComparer.cs
namespace System.Collections
{
    public interface IEqualityComparer
    {
        // 判断两个对象 x 和 y 是否相等
        bool Equals(object? x, object? y);

        // 需遵循 “相等的对象必须返回相同哈希码” 的原则（反之不要求）
        int GetHashCode(object obj);
    }
}

对应的泛型接口：

// \runtime\src\libraries\System.Private.CoreLib\src\System\Collections\Generic\IEqualityComparer.cs
using System.Diagnostics.CodeAnalysis;

namespace System.Collections.Generic
{
    public interface IEqualityComparer<in T>
    {
        bool Equals(T? x, T? y);
        int GetHashCode([DisallowNull] T obj);
    }
}

基于相等性的比较：

// \runtime\src\libraries\System.Private.CoreLib\src\System\Collections\Generic\IStructuralEquatable.cs
namespace System.Collections
{
    public interface IStructuralEquatable
    {
        bool Equals(object? other, IEqualityComparer comparer);
        int GetHashCode(IEqualityComparer comparer);
    }
}