CodeQL documentation

Inconsistent CompareTo and Equals

ID: cs/inconsistent-compareto-and-equals
Kind: problem
Severity: warning
Precision: medium
   - reliability
   - maintainability
Query suites:
   - csharp-security-and-quality.qls

Click to see the query in the CodeQL repository

When an ordering is introduced on instances of a class by making the class implement the IComparable interface, it is sensible to ensure that for all instances c1 and c2, c1.CompareTo(c2) == 0c1.Equals(c2). Classes that implement IComparable.CompareTo but inherit Equals, rather than overriding it to match the CompareTo implementation, generally violate this assumption, which can lead to confusion when the class is used.

If the type implements IComparable, it should override Equals.

- Microsoft: Guidelines for Overloading Equals() and Operator ==


A class that implements CompareTo should generally also override Equals in order to provide a consistent implementation.


The following example outputs:

Comparing a1 with a2: 0
a1 equals a2: False

This is obviously not desirable as shows an inconsistency between the behavior of CompareTo and the behavior of Equals.

class InconsistentCompareTo
    class Age : IComparable<Age>
        private int age;
        public Age(int age)
            this.age = age;
        public int CompareTo(Age rhs)
            return age.CompareTo(rhs.age);

    public static void Main(string[] args)
        Age a1 = new Age(22);
        Age a2 = new Age(22);
        Console.WriteLine("Comparing a1 with a2: " + a1.CompareTo(a2));
        Console.WriteLine("a1 equals a2: " + a1.Equals(a2));