C# tutorials > Core C# Fundamentals > Basics and Syntax > What is the difference between `==` and `.Equals()`?

What is the difference between `==` and `.Equals()`?

Understanding the nuances between `==` and `.Equals()` is crucial in C# for accurate object comparison. While both are used to check for equality, they operate differently depending on the data type being compared. This tutorial will delve into their differences, providing clarity through examples and best practices.

Introduction to `==` Operator

The `==` operator is an equality operator in C#. Its behavior depends on whether you are comparing value types or reference types.
- For value types (e.g., `int`, `double`, `bool`, `struct`), `==` compares the values of the operands. If the values are identical, `==` returns `true`; otherwise, it returns `false`.
- For reference types (e.g., `class`, `string`, `array`), `==` by default compares the *references* of the operands. This means it checks if the two operands point to the same object in memory. If they do, `==` returns `true`; otherwise, it returns `false`. However, the `==` operator can be overloaded in custom classes and structs to provide custom equality logic.

Introduction to `.Equals()` Method

The `.Equals()` method is a virtual method defined in the `System.Object` class, meaning all classes in C# inherit it. By default, `.Equals()` behaves the same as `==` for reference types, comparing references. However, the power of `.Equals()` lies in its ability to be overridden in derived classes to provide custom equality logic based on the *content* of the objects, rather than just their memory addresses.
Value types usually override `.Equals()` to compare the values of the instances.

Code Example: Value Types

In this example, both `==` and `.Equals()` compare the values of the integers, resulting in `true` for both. For value types like `int`, the behavior is identical.

csharp
int x = 5;
int y = 5;

Console.WriteLine(x == y); // Output: True
Console.WriteLine(x.Equals(y)); // Output: True

Code Example: Reference Types (String)

Strings in C# are a special case. Even though `string` is a reference type, the `==` operator is overloaded to compare the *values* of the strings, not their references. The `.Equals()` method also compares the values, resulting in the same outcome.

csharp
string str1 = "Hello";
string str2 = "Hello";

Console.WriteLine(str1 == str2); // Output: True
Console.WriteLine(str1.Equals(str2)); // Output: True

Code Example: Reference Types (Custom Class - No Override)

In this case, `person1` and `person2` are different objects in memory, even though their properties have the same values. Since neither the `==` operator nor the `.Equals()` method are overridden, they both compare references, resulting in `false`.

csharp
public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }

    public Person(string name, int age)
    {
        Name = name;
        Age = age;
    }
}

Person person1 = new Person("Alice", 30);
Person person2 = new Person("Alice", 30);

Console.WriteLine(person1 == person2); // Output: False
Console.WriteLine(person1.Equals(person2)); // Output: False

Code Example: Reference Types (Custom Class - Override)

Here, we've overridden both the `.Equals()` method and the `==` operator in the `Person` class. The `Equals()` method now compares the `Name` and `Age` properties. The `==` operator is also overloaded to use the custom `Equals()` implementation. Crucially, `GetHashCode()` is also overridden, because when you override `Equals()`, you *must* also override `GetHashCode()` to maintain consistency for collections that rely on hashing (e.g., `Dictionary`, `HashSet`). The output is now `true` because the *content* of the objects is the same.

csharp
public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }

    public Person(string name, int age)
    {
        Name = name;
        Age = age;
    }

    public override bool Equals(object obj)
    {
        if (obj == null || GetType() != obj.GetType())
        {
            return false;
        }

        Person other = (Person)obj;
        return Name == other.Name && Age == other.Age;
    }

    public override int GetHashCode()
    {
        // Important: Override GetHashCode() whenever you override Equals()
        return HashCode.Combine(Name, Age);
    }

    public static bool operator ==(Person a, Person b)
    {
        if (ReferenceEquals(a, b))
        {
            return true;
        }

        if (a is null || b is null)
        {
            return false;
        }

        return a.Equals(b);
    }

    public static bool operator !=(Person a, Person b)
    {
        return !(a == b);
    }
}

Person person1 = new Person("Alice", 30);
Person person2 = new Person("Alice", 30);

Console.WriteLine(person1 == person2); // Output: True
Console.WriteLine(person1.Equals(person2)); // Output: True

Concepts Behind the Snippet

The core concept is understanding the difference between comparing object identity (references) and object state (content). The default behavior of `==` and `.Equals()` for reference types is to compare object identity. By overriding `.Equals()` and optionally overloading `==`, you can define equality based on the object's state. Proper implementation of `GetHashCode()` is essential when overriding `Equals()` for correct behavior in hash-based collections.

Real-Life Use Case Section

Consider a scenario where you're building an e-commerce application and you have a `Product` class. You want to determine if two `Product` objects are the same based on their `ProductID`. Overriding `.Equals()` in the `Product` class allows you to compare `Product` instances based on their unique identifier, regardless of whether they are different object instances in memory. This is crucial for features like comparing items in a shopping cart or detecting duplicate products. Another example would be in a game application where you have a `GameObject` class and you want to see if two objects represent the same entity based on their ID or other properties.

Best Practices

  • When overriding `.Equals()`, always override `GetHashCode()` to ensure consistency. The hash code should be derived from the same fields used in the `Equals()` comparison.
  • If you override `==`, also override `!=` to maintain consistency.
  • Consider implementing `IEquatable` for type safety and performance. This interface defines a strongly-typed `Equals()` method.
  • When comparing strings, use `String.Equals(string a, string b, StringComparison comparisonType)` to specify the comparison rules (e.g., case-insensitive comparison).

Interview Tip

Be prepared to explain the difference between `==` and `.Equals()` with examples, including value types, reference types, and scenarios where overriding is necessary. Understand the importance of `GetHashCode()` when overriding `Equals()`. A good interviewer will also ask about string interning and how it affects `==` comparison for strings. Understanding the benefits of `IEquatable` is also beneficial.

When to use them

Use `==` for simple value comparisons and when you want to compare references directly. Use `.Equals()` when you need custom equality logic based on the object's state. When in doubt, especially with reference types, override `.Equals()` and `GetHashCode()` to define meaningful equality for your objects.

Memory footprint

The memory footprint difference between using `==` and `.Equals()` is usually negligible. However, if you have a complex equality comparison in `.Equals()`, it may have a slightly larger runtime footprint compared to a simple reference comparison with `==`. Overriding `.Equals()` and not implementing `GetHashCode()` correctly can lead to increased memory usage and performance issues if the objects are used in hash-based collections.

Alternatives

Alternatives to manually overriding `Equals()` include using libraries like AutoFixture or comparing serialized representations of objects. However, these approaches often come with a performance overhead and may not be suitable for all scenarios. Another alternative is to use record types in C# 9 and later, which automatically provide value-based equality.

Pros of Overriding `.Equals()`

  • Provides custom equality logic tailored to your object's state.
  • Enables meaningful comparisons for complex objects.
  • Essential for using custom objects as keys in dictionaries and other hash-based collections.
  • Allows you to define what it means for two objects to be considered the 'same' in your application.

Cons of Overriding `.Equals()`

  • Requires careful implementation to ensure correctness and consistency with `GetHashCode()`.
  • Can introduce performance overhead if the equality logic is complex.
  • If not implemented correctly, can lead to subtle bugs and unexpected behavior, especially in collections.
  • Overriding `.Equals()` and failing to overload the `==` operator can lead to confusion and inconsistencies.

← What is the difference between .NET Framework, .NET Core, and .NET 5+? What is the difference between `List<T>`, `ArrayList`, and `LinkedList<T>`? →

FAQ

  • Why do I need to override `GetHashCode()` when I override `Equals()`?

    The `GetHashCode()` method is used by hash-based collections (like `Dictionary` and `HashSet`) to efficiently store and retrieve objects. If two objects are equal according to `Equals()`, their `GetHashCode()` methods *must* return the same value. If you override `Equals()` but not `GetHashCode()`, you violate this contract, and hash-based collections may behave incorrectly (e.g., returning `null` when searching for an object that exists).
  • When should I use `==` instead of `.Equals()`?

    Use `==` when you want to compare value types directly or when you want to check if two reference types point to the exact same object in memory (identity comparison). If you need to compare objects based on their content, override `.Equals()` to define custom equality logic. For strings, `==` is generally preferred because it's overloaded to compare string values.
  • What is the difference between `Equals()` and `ReferenceEquals()`?

    The `Equals()` method is a virtual method that can be overridden to provide custom equality logic for a class. The `ReferenceEquals()` method, on the other hand, is a static method that always compares references, regardless of whether `Equals()` is overridden. `ReferenceEquals()` checks if two references point to the exact same object in memory.