Skip to content

Using Tuples for Overriding Equality and GetHashCode

Overriding Objects

The implementation of Equals() and GetHashCode() used to be complex, but with C# 7.0 Tuples, the actual code is boilerplate.

  • For Equals(): It’s necessary to compare all the contained identifying data structures while avoiding infinite recursion or null reference exceptions.
  • For GetHashCode(): It’s necessary to combine the unique hash code of each of the non-null contained identifying data structures in an exclusive OR operation.

With C# 7.0 tuples, overriding Equals() and GetHashCode() turns out to be quite simple as demonstrated in Figure 1.

public struct Arc {
  public Arc(double radius, double startAngle, double sweepAngle) {
    Radius = radius;
    StartAngle = startAngle;
    SweepAngle = sweepAngle;
  }
  public double Radius;
  public double StartAngle;
  public double SweepAngle;
  public double Length {
    get {
      return Math.Abs(StartAngle - SweepAngle) /
        360 * 2 * Math.PI * Radius;
    }
  }
  public void Rotate(double degrees) {
    StartAngle += degrees;
    SweepAngle += degrees;
  }
  // override object.Equals
  public override bool Equals(object obj) {
    return (obj is Arc) &&
      Equals((Arc) obj);
  }
  // Implemented IEquitable<T>
  public bool Equals(Arc arc) {
    return (Radius, StartAngle, SweepAngle).Equals(
      (arc.Radius, arc.StartAngle, arc.SweepAngle));
  }
  // override object.GetHashCode
  public override int GetHashCode() =>
    (Radius, StartAngle, SweepAngle).GetHashCode();
  public static bool operator == (
    Arc lhs, Arc rhs) => lhs.Equals(rhs);
  public static bool operator != (
    Arc lhs, Arc rhs) => !lhs.Equals(rhs);
}Code language: PHP (php)

For Equals, one member can check that the type is the same, while a second member groups each of the identifying members into a tuple and compares them to the target parameter of the same type, like this:

public bool Equals(Arc arc) =>

return (Radius, StartAngle, SweepAngle).Equals(

(arc.Radius, arc.StartAngle, arc.SweepAngle));Code language: PHP (php)

One might argue that the second function could be more readable if each identifying member were explicitly compared, instead. But, I leave that for the reader to arbitrate. That said, note that internally the tuple (System.ValueTuple<…>) uses EqualityComparer<T>, which relies on the type parameters implementation of IEquatable<T> (which only contains a single Equals<T>(T other) member).

Therefore, to correctly override Equals, you need to follow the guideline:

DO implement IEquatable<T> when overriding Equals.

That way your own custom data types will leverage your custom implementation of Equals() rather than Object.Equals().

Perhaps the more compelling of the two overloads is GetHashCode() and its use of the tuple. Rather than engage in the complex gymnastics of an exclusive OR operation of the non-null identifying members, you can simply instantiate a tuple of all identifying members and return the GetHashCode() value for the said tuple.  Like so:

public override int GetHashCode() => return (Radius, StartAngle, SweepAngle).GetHashCode();

In summary, C# 7.0’s new tuple type provides a great shortcut to overriding object‘s Equals() and GetHashCode() members.

4 thoughts on “Using Tuples for Overriding Equality and GetHashCode”

  1. I really like this implementation. Was using it as a guide when writing my own. I found that == and != operators will throw null reference error if lhs is null. Since default implementation of == and != operators does not bomb when null, I think this should be accounted for. Similarly said for Equals(Arc arc) if arc is null. In my code, I accounted for this by utilizing a static GetHashCode(Arc arc) method.

    public static Int32 GetHashCode(Arc arc)
    {
    if (arc is null)
    return 0;

    return (arc.Radius, arc.StartAngle, arc.SweepAngle).GetHashCode();
    }

    This allows you to simplify both Equals methods, operator methods, and non-static GetHashCode() to all call this static GetHashCode(Arc arc).

  2. Be very careful, however. If you have 8+ items in the Tuple, the Tuple’s GetHashCode() value get’s wonky, and appears to only use the last 8 items (not the first 8)
    (1, 10, “”, 2, 42, “ABC”, 723, 1000652, 4).GetHashCode() ==
    (5, 10, “”, 2, 42, “ABC”, 723, 1000652, 4).GetHashCode()

    (1, 10, “”, 2, 42, “ABC”, 723, 1000652).GetHashCode().Dump() !=
    (5, 10, “”, 2, 42, “ABC”, 723, 1000652).GetHashCode().Dump()

    (5, 10, “”, 2, 42, “ABC”, 723, 1000652, 2).GetHashCode().Dump() !=
    (5, 10, “”, 2, 42, “ABC”, 723, 1000652, 3).GetHashCode().Dump();

Leave a Reply

Your email address will not be published. Required fields are marked *