Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

System.IEquatable<T> — tipizirana jednakost

System.IEquatable<T> definira Equals(T), usporedbu jednakosti s argumentom određenog tipa. Dosljedna implementacija obuhvaća i Equals(object), GetHashCode() te operatore == i !=, kako bi se prilagođeni tip predvidljivo ponašao u kolekcijama.

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

Sintaksa

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> omogućuje definiranje jednakosti za određeni tip; obično je T tip koji implementira sučelje, primjerice ItemId : IEquatable<ItemId>. Metoda Equals(T) vraća true kada su vrijednosti jednake prema odabranom pravilu. Ne definira redoslijed sortiranja — za to služi IComparable<T>. Sučelje je dostupno u .NET 10; primjer ne zahtijeva funkcionalnosti preview.

Equals(T) treba biti refleksivna, simetrična i tranzitivna te davati dosljedne rezultate dok se podaci ne mijenjaju. Kod klase usporedba s null treba vratiti false. Nadjačajte i Equals(object) i GetHashCode() te ih uskladite s tipiziranom jednakošću. Sučelje samo ne definira operatore == i !=; ako ih omogućite, moraju slijediti isto pravilo.

EqualityComparer<T>.Default koristi IEquatable<T> kada ga tip implementira. Tako generičke kolekcije mogu koristiti tipiziranu jednakost i izbjeći boxing struktura tijekom te usporedbe. Vlastiti comparer proslijeđen kolekciji može primijeniti drugo pravilo. Eksplicitno pretvaranje strukture u object i dalje uzrokuje boxing, kao u drugom pozivu primjera.

Jednake vrijednosti moraju davati jednake rezultate metode GetHashCode(), ali jednaki hashovi ne dokazuju jednakost. Nemojte mijenjati podatke koji određuju jednakost ili hash dok je objekt ključ u Dictionary<TKey,TValue> ili element u HashSet<T>. Primjer koristi nepromjenjivu strukturu: dva identifikatora čiji je Value jednak 42 jednaka su, pa HashSet<ItemId> odbacuje duplikat.

Primjeri

#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);
    }
}

Rezultat

True
True
True
True
False
1

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori