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

CKTIS / C#

System.IEquatable<T> — typově bezpečná rovnost

System.IEquatable<T> definuje Equals(T), porovnání rovnosti s argumentem konkrétního typu. Konzistentní implementace zahrnuje také Equals(object), GetHashCode() a operátory == a !=, aby se vlastní typ v kolekcích choval předvídatelně.

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

Syntaxe

public readonly struct ItemId : System.IEquatable<ItemId>
{
    public int Value { get; }

    public ItemId(int value) => Value = value;

    public bool Equals(ItemId other) => Value == other.Value;
}

System.IEquatable<T> umožňuje definovat rovnost pro konkrétní typ; T je obvykle typ, který rozhraní implementuje, například ItemId : IEquatable<ItemId>. Metoda Equals(T) vrací true, pokud jsou hodnoty podle zvoleného pravidla stejné. Nedefinuje pořadí řazení — to je úlohou IComparable<T>. Rozhraní je dostupné v .NET 10; příklad nevyžaduje funkce ve verzi preview.

Equals(T) by měla být reflexivní, symetrická a tranzitivní a při nezměněných datech vracet konzistentní výsledky. U třídy by porovnání s null mělo vracet false. Přepište také Equals(object) a GetHashCode() tak, aby byly v souladu s typovanou rovností. Rozhraní samo nedefinuje operátory == a !=; pokud je poskytujete, musí se řídit stejným pravidlem.

EqualityComparer<T>.Default používá IEquatable<T>, pokud typ toto rozhraní implementuje. Generické kolekce tak mohou používat typovanou rovnost a při tomto porovnání se vyhnout boxingu struktur. Vlastní comparer předaný kolekci může použít jiné pravidlo. Explicitní převod struktury na object stále způsobuje boxing, jak ukazuje druhé volání v příkladu.

Stejné hodnoty musí vracet stejné výsledky GetHashCode(), ale shodné hashe nedokazují rovnost. Neměňte data, která určují rovnost nebo hash, když je objekt klíčem v Dictionary<TKey,TValue> nebo prvkem v HashSet<T>. Příklad používá neměnnou strukturu: dva identifikátory, jejichž Value je 42, jsou stejné, takže HashSet<ItemId> duplicitní hodnotu odmítne.

Příklady

#nullable enable
using System;
using System.Collections.Generic;

public readonly struct ItemId : IEquatable<ItemId>
{
    public int Value { get; }

    public ItemId(int value) => Value = value;

    public bool Equals(ItemId other) => Value == other.Value;
    public override bool Equals(object? obj) =>
        obj is ItemId other && Equals(other);
    public override int GetHashCode() => Value;

    public static bool operator ==(ItemId left, ItemId right) =>
        left.Equals(right);
    public static bool operator !=(ItemId left, ItemId right) =>
        !left.Equals(right);
}

public static class Program
{
    public static void Main()
    {
        var first = new ItemId(42);
        var same = new ItemId(42);
        var ids = new HashSet<ItemId> { first };

        Console.WriteLine(first.Equals(same));
        Console.WriteLine(first.Equals((object)same));
        Console.WriteLine(first == same);
        Console.WriteLine(ids.Contains(same));
        Console.WriteLine(ids.Add(same));
        Console.WriteLine(ids.Count);
    }
}

Výsledek

True
True
True
True
False
1

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