File: objc-missing-hash.rst

package info (click to toggle)
llvm-toolchain-11 1%3A11.0.1-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 995,808 kB
  • sloc: cpp: 4,767,656; ansic: 760,916; asm: 477,436; python: 170,940; objc: 69,804; lisp: 29,914; sh: 23,855; f90: 18,173; pascal: 7,551; perl: 7,471; ml: 5,603; awk: 3,489; makefile: 2,573; xml: 915; cs: 573; fortran: 503; javascript: 452
file content (16 lines) | stat: -rw-r--r-- 678 bytes parent folder | download | duplicates (25) 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
 
.. title:: clang-tidy - objc-missing-hash

objc-missing-hash
=================

Finds Objective-C implementations that implement ``-isEqual:`` without also
appropriately implementing ``-hash``.

Apple documentation highlights that objects that are equal must have the same
hash value:
https://developer.apple.com/documentation/objectivec/1418956-nsobject/1418795-isequal?language=objc

Note that the check only verifies the presence of ``-hash`` in scenarios where
its omission could result in unexpected behavior. The verification of the
implementation of ``-hash`` is the responsibility of the developer, e.g.,
through the addition of unit tests to verify the implementation.