C# Academy · 강의

IEquatable 구현

Equals로 형식이 안전한 같음 비교를 제공합니다.

IEquatable 구현은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

IEquatable<T>가 필요한 이유

IEquatable<T>는 강력한 형식이 적용된 Equals(T other) 메서드를 제공합니다. 값 형식에서는 박싱을 피하고 참조 형식에서는 캐스팅을 피하므로, 같음 판단을 더 빠르고 명확하게 수행할 수 있습니다.

인터페이스 구현하기

IEquatable<T>를 구현하고 Equals(T other)를 제공하십시오. 또한 상속된 object.Equals와 GetHashCode를 재정의하여 모든 경로가 일관되도록 해야 합니다.

using System;

public struct Point : IEquatable<Point>
{
    public int X, Y;
    public Point(int x, int y) { X = x; Y = y; }

    public bool Equals(Point other) => X == other.X && Y == other.Y;
    public override bool Equals(object obj) => obj is Point p && Equals(p);
    public override int GetHashCode() => HashCode.Combine(X, Y);
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(new Point(1, 2).Equals(new Point(1, 2)));
    }
}

구조체의 박싱 피하기

제네릭이 아닌 object.Equals(object)는 구조체 인수를 박싱합니다. IEquatable<T>에서 제공하는 형식 지정 Equals(Point other)는 구조체를 직접 받으므로 할당이 발생하지 않습니다.

using System;

public struct Point : IEquatable<Point>
{
    public int X, Y;
    public Point(int x, int y) { X = x; Y = y; }
    public bool Equals(Point other) => X == other.X && Y == other.Y; // no boxing
    public override bool Equals(object obj) => obj is Point p && Equals(p);
    public override int GetHashCode() => HashCode.Combine(X, Y);
}

public class Program
{
    public static void Main()
    {
        Point a = new Point(3, 4);
        Point b = new Point(3, 4);
        Console.WriteLine(a.Equals(b)); // calls the typed overload
    }
}

컬렉션은 IEquatable<T>를 사용합니다

List<T>.Contains, Dictionary, HashSet은 사용 가능한 경우 IEquatable<T>.Equals를 우선합니다. 이를 구현하면 이러한 작업이 해당 형식에서 효율적이고 올바르게 수행됩니다.

using System;
using System.Collections.Generic;

public struct Point : IEquatable<Point>
{
    public int X, Y;
    public Point(int x, int y) { X = x; Y = y; }
    public bool Equals(Point other) => X == other.X && Y == other.Y;
    public override bool Equals(object obj) => obj is Point p && Equals(p);
    public override int GetHashCode() => HashCode.Combine(X, Y);
}

public class Program
{
    public static void Main()
    {
        var list = new List<Point> { new Point(0, 0), new Point(1, 1) };
        Console.WriteLine(list.Contains(new Point(1, 1)));
    }
}

참조 형식과 IEquatable<T>

클래스도 IEquatable<T>를 구현할 수 있습니다. 형식 지정 Equals는 캐스팅을 피하며, 참조 매개 변수의 null은 직접 처리해야 합니다.

using System;

public class Person : IEquatable<Person>
{
    public string Name;
    public Person(string name) { Name = name; }

    public bool Equals(Person other) => other != null && other.Name == Name;
    public override bool Equals(object obj) => Equals(obj as Person);
    public override int GetHashCode() => Name?.GetHashCode() ?? 0;
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(new Person("Ada").Equals(new Person("Ada")));
        Console.WriteLine(new Person("Ada").Equals((Person)null));
    }
}

object.Equals를 형식 지정 메서드로 연결하기

깔끔한 패턴은 Equals(T)에 비교를 한 번만 작성하고 object.Equals가 이를 위임하도록 하는 것입니다. 이렇게 하면 두 메서드가 항상 동일하게 동작합니다.

using System;

public struct Id : IEquatable<Id>
{
    public int Value;
    public Id(int value) { Value = value; }
    public bool Equals(Id other) => Value == other.Value;
    public override bool Equals(object obj) => obj is Id other && Equals(other);
    public override int GetHashCode() => Value;
}

public class Program
{
    public static void Main()
    {
        object boxed = new Id(5);
        Console.WriteLine(boxed.Equals(new Id(5)));
    }
}

여러 필드 비교하기

필드가 여러 개인 형식에서는 Equals에서 모든 필드를 비교하십시오. 관련된 모든 필드가 일치할 때만 두 인스턴스를 같은 것으로 판단합니다.

using System;

public struct DateRange : IEquatable<DateRange>
{
    public int Start, End;
    public DateRange(int start, int end) { Start = start; End = end; }
    public bool Equals(DateRange other) => Start == other.Start && End == other.End;
    public override bool Equals(object obj) => obj is DateRange d && Equals(d);
    public override int GetHashCode() => HashCode.Combine(Start, End);
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(new DateRange(1, 5).Equals(new DateRange(1, 5)));
        Console.WriteLine(new DateRange(1, 5).Equals(new DateRange(1, 6)));
    }
}

연산자와 함께 사용하기

IEquatable<T>를 == 및 !=와 함께 사용하면 사용자가 어느 구문으로든 비교할 수 있으며, 모든 비교가 동일한 형식 지정 비교를 기반으로 수행됩니다.

using System;

public struct Money : IEquatable<Money>
{
    public decimal Amount;
    public Money(decimal a) { Amount = a; }
    public bool Equals(Money other) => Amount == other.Amount;
    public override bool Equals(object obj) => obj is Money m && Equals(m);
    public override int GetHashCode() => Amount.GetHashCode();
    public static bool operator ==(Money a, Money b) => a.Equals(b);
    public static bool operator !=(Money a, Money b) => !a.Equals(b);
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(new Money(9.99m) == new Money(9.99m));
    }
}

레코드는 이를 자동으로 구현합니다

C# record는 IEquatable<T>, 값 기반 Equals, GetHashCode를 자동으로 생성합니다. 값 기반 같음 판단만 필요하다면 레코드를 사용하여 반복적인 코드를 줄일 수 있습니다.

using System;

public record Point(int X, int Y);

public class Program
{
    public static void Main()
    {
        var a = new Point(1, 2);
        var b = new Point(1, 2);
        Console.WriteLine(a.Equals(b));
        Console.WriteLine(a == b);
    }
}

직접 구현해야 하는 경우

대소문자를 구분하지 않는 이름 비교나 특정 필드 무시처럼 레코드가 직접 표현할 수 없는 사용자 지정 같음 규칙이 필요할 때는 IEquatable<T>를 직접 구현하십시오.

using System;

public class CaseInsensitiveTag : IEquatable<CaseInsensitiveTag>
{
    public string Name;
    public CaseInsensitiveTag(string name) { Name = name; }
    public bool Equals(CaseInsensitiveTag other)
        => other != null && string.Equals(Name, other.Name, StringComparison.OrdinalIgnoreCase);
    public override bool Equals(object obj) => Equals(obj as CaseInsensitiveTag);
    public override int GetHashCode() => Name?.ToLowerInvariant().GetHashCode() ?? 0;
}

public class Program
{
    public static void Main()
    {
        Console.WriteLine(new CaseInsensitiveTag("Red").Equals(new CaseInsensitiveTag("RED")));
    }
}

직접 해 보기

작은 참조 형식에 IEquatable<T>를 구현하고, 모든 같음 판단 경로가 형식 지정 메서드를 거치도록 연결하십시오.

using System;
using System.Collections.Generic;

public class Coordinate : IEquatable<Coordinate>
{
    public int Lat, Lng;
    public Coordinate(int lat, int lng) { Lat = lat; Lng = lng; }
    public bool Equals(Coordinate other) => other != null && other.Lat == Lat && other.Lng == Lng;
    public override bool Equals(object obj) => Equals(obj as Coordinate);
    public override int GetHashCode() => HashCode.Combine(Lat, Lng);
}

public class Program
{
    public static void Main()
    {
        var set = new HashSet<Coordinate> { new Coordinate(10, 20) };
        Console.WriteLine(set.Contains(new Coordinate(10, 20)));
    }
}

빠른 확인

IEquatable의 이점을 떠올려 보십시오.

복습

IEquatable<T>는 형식 안전한 같음 판단을 제공합니다.

Equals(T other)를 제공하여 구조체의 박싱과 클래스의 캐스팅을 피합니다.
컬렉션은 올바르고 효율적인 검색을 위해 이를 우선 사용합니다.
object.Equals와 연산자가 형식 지정 메서드를 사용하도록 연결하십시오.
레코드는 이를 자동으로 구현하며, 사용자 지정 규칙이 필요할 때는 직접 구현하십시오.

자주 묻는 질문

“IEquatable 구현” 강의는 무료인가요?

네 — “IEquatable 구현” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“IEquatable 구현”에서 뭘 배우나요?

Equals로 형식이 안전한 같음 비교를 제공합니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

C# Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“IEquatable 구현” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← C# Academy(으)로 돌아가기