When ARC came to Objective-C, I did my best to read through the Objective-C Automatic Reference Counting (ARC) guide posted on the Clang project website to get a better hang of what it was about. What I found there (and no where else) was mention of using __attribute__ declarations to signify to ARC whether certain code autoreleases its return value, for instance (__attribute__((ns_returns_autoreleased))), or whether it ‘consumes’ a parameter (__attribute((ns_consumed)), and so on.
However, it seems that the guide gives very little word on the actual level of necessity these declarations hold. Excluding them seems to make no difference, neither when running the static analyzer nor when running the project itself. Do these even make a difference? Is there any advantage to labeling a method with __attribute__((objc_method_family(new)))? No article I’ve found on ARC makes mention of these specifiers at all; perhaps an ARC guru can give word on what these are used for.
(Personally, I include all relevant specifiers just in case, but find that they make code obfuscated and messy.)
That’s not necessary in most of the cases, since LLVM & Clang knows ObjC naming conventions. So if you follow the standard naming conventions of Cocoa, LLVM automagically assumes the corresponding family/return memory policy to follow.
Namely, if you declare a method named
initWith...it will automatically consider it as the “init” family of methods, no need to specify__attribute__((objc_method_family(init))), Clang automatically detect it; same for thenewfamily, etc.In fact, you only need to use the
__attribute__specifiers when Clang can’t guess such cases, which in practice rarely occurs (in practice I never had to use it), or only if you don’t respect naming conventions:Quoting Clang Language Extensions Documentation:
So as soon as you respect the naming conventions (which you should always do) you won’t have anything do to.