Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

System.IEquatable<T> — typovo bezpečná rovnosť

System.IEquatable<T> definuje Equals(T), porovnanie rovnosti s argumentom konkrétneho typu. Konzistentná implementácia zahŕňa aj Equals(object), GetHashCode() a operátory == a !=, aby sa vlastný typ v kolekciách správal predvídateľne.

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

Syntax

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 definovať rovnosť pre konkrétny typ; T je zvyčajne typ, ktorý rozhranie implementuje, napríklad ItemId : IEquatable<ItemId>. Metóda Equals(T) vracia true, keď sú hodnoty podľa zvoleného pravidla rovnaké. Nedefinuje poradie triedenia — to je úlohou IComparable<T>. Rozhranie je dostupné v .NET 10; príklad nevyžaduje funkcie vo verzii preview.

Equals(T) by mala byť reflexívna, symetrická a tranzitívna a pri nezmenených údajoch vracať konzistentné výsledky. Pri triede by porovnanie s null malo vrátiť false. Prepíšte aj Equals(object) a GetHashCode() tak, aby boli v súlade s typovanou rovnosťou. Rozhranie samo nedefinuje operátory == a !=; ak ich poskytujete, musia sa riadiť rovnakým pravidlom.

EqualityComparer<T>.Default používa IEquatable<T>, keď typ toto rozhranie implementuje. Generické kolekcie tak môžu používať typovanú rovnosť a pri tomto porovnaní sa vyhnúť boxingu štruktúr. Vlastný comparer odovzdaný kolekcii môže uplatniť iné pravidlo. Explicitné pretypovanie štruktúry na object stále spôsobí boxing, ako ukazuje druhé volanie v príklade.

Rovnaké hodnoty musia vracať rovnaké výsledky GetHashCode(), ale rovnaké hashe nedokazujú rovnosť. Nemeňte údaje, ktoré určujú rovnosť alebo hash, keď je objekt kľúčom v Dictionary<TKey,TValue> alebo prvkom v HashSet<T>. Príklad používa nemennú štruktúru: dva identifikátory, ktorých Value je 42, sú rovnaké, takže HashSet<ItemId> duplikát odmietne.

Prí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ýsledok

True
True
True
True
False
1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje