Равенство

Структурное равенство

Структурное равенство проверяется операцией == и ее инверсией !=. По соглашению, выражение типа a == b переводится в:

a?.equals(b) ?: (b === null)

Если a не null, вызывается функция equals(Any?), в противном случае (a равно null) проверяется, что b ссылочно равно null.

Обратите внимание, что нет смысла оптимизировать код при сравнении с null явно: a == null будет автоматически переведено в a === null.

Для предоставления собственной реализации проверки на равенство переопределите функцию equals(other: Any?): Boolean. Функции с тем же именем и другими сигнатурами, например equals(other: Foo), не влияют на проверки равенства с операторами == и !=.

Структурное равенство не имеет отношения к сравнению, определенному интерфейсом Comparable<...>, поэтому только кастомная реализация equals(Any?) может повлиять на поведение оператора.

Ссылочное равенство

Ссылочное равенство проверяется операцией === и ее инверсией !==. a === b истинно тогда и только тогда, когда a и b указывают на один и тот же объект. Для значений, представленных примитивными типами во время выполнения (например, Int), проверка равенства === эквивалентна проверке ==.

Равенство чисел с плавающей точкой

Когда операнды проверки на равенство статически известны как Float или Double (с возможностью быть null или без), проверка подчиняется Стандарту IEEE 754 для арифметики с плавающей точкой.

В противном случае используется структурное равенство, что не соответствует стандарту, поэтому NaN равно самому себе, а -0.0 не равно 0.0.

См.: Сравнение чисел с плавающей точкой.