Clang Attributes是Clang提供的一種源碼注解奈辰,方便開發(fā)者向編譯器表達(dá)某種要求栏妖,參與控制如Static Analyzer、Name Mangling奖恰、Code Generation等過程吊趾,一般以attribute(xxx)的形式出現(xiàn)在代碼中;為方便使用瑟啃,一些常用屬性也被Cocoa定義成宏论泛,比如在系統(tǒng)頭文件中經(jīng)常出現(xiàn)的NS_CLASS_AVAILABLE_IOS(9_0)就是attribute(availability(...))這個(gè)屬性的簡單寫法。
※unavailable
#define UNAVAILABLE_ATTRIBUTE __attribute__((unavailable))
可以加在方法聲明的后面蛹屿,告訴編譯器該方法不可用
Swift中
@available(*, unavailable)
func foo() {}
@available(iOS, unavailable, message="you can't call this")
func foo2() {}
※availability
#define NS_DEPRECATED_IOS(_iosIntro,_iosDep,...) CF_DEPRECATED_IOS(_iosIntro,_iosDep,__VA_ARGS__)
展開看
#define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...)
__attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))
再展開看
__attribute__((availability(ios,introduced=2_0,deprecated=7_0,message=""__VA_ARGS__)))
iOS即是iOS平臺(tái)
introduced從哪個(gè)版本開始使用
deprecated從哪個(gè)版本開始棄用
message警告的信息
其實(shí)還可以再加一個(gè)參數(shù)例子:
void f(void) __attribute__((availability(macosx,introduced=10.4,deprecated=10.6,obsoleted=10.7)));
obsoleted完全禁止使用的版本
NS_AVAILABLE_IOS(7_0)
iOS7.0或之后才能使用
NS_DEPRECATED_IOS(2_0,6_0)
iOS2.0開始使用6.0廢棄
Swift中:
@available(iOS 6.0, *)
public var minimumScaleFactor: CGFloat
@available(OSX, introduced=10.4, deprecated=10.6, obsoleted=10.10)
@available(iOS, introduced=5.0, deprecated=7.0)
func foo3() {}
※objc_subclassing_restricted
一句話就是使用這個(gè)屬性可以定義一個(gè)不可被繼承的類
__attribute__((objc_subclassing_restricted))
@interface Eunuch : NSObject
@end
@interface Child : Eunuch//如果繼承它會(huì)報(bào)錯(cuò)
@end
在Swift中對(duì)原來的很多attribute的支持現(xiàn)在還缺失中屁奏,為了達(dá)到類似的目的,我們可以使用一個(gè)final關(guān)鍵詞
※objc_requires_super
使用這個(gè)屬性標(biāo)志子類繼承這個(gè)方法時(shí)需要調(diào)用super错负,否則給出編譯警告了袁,來讓父類中有一些關(guān)鍵代碼是在被繼承重寫后必須執(zhí)行
#define NS_REQUIRES_SUPER __attribute__((objc_requires_super))
在Switf中也還是可以用final的方法來達(dá)到這個(gè)目的
Swift equivalent to __attribute((objc_requires_super))?(stackoverflow)
※overloadable
用于C函數(shù),可以定義若干個(gè)相同函數(shù)名湿颅,但參數(shù)不同的方法载绿,調(diào)用時(shí)編譯器會(huì)自動(dòng)根據(jù)參數(shù)選擇函數(shù)去調(diào)用
__attribute__((overloadable))
void logAnything(id obj) {
NSLog(@"%@", obj);
}
__attribute__((overloadable)) void logAnything(int number) {
NSLog(@"%@", @(number));
}
__attribute__((overloadable)) void logAnything(CGRect rect) {
NSLog(@"%@", NSStringFromCGRect(rect));
}
// Tests
logAnything(@[@"1", @"2"]);
logAnything(233);
logAnything(CGRectMake(1, 2, 3, 4));
有興趣的可以寫一個(gè)自定義的Log免去用NSLog要寫@""等格式的麻煩
※cleanup
__attribute__((cleanup(...)))
,用于修飾一個(gè)變量油航,在它的作用域結(jié)束時(shí)可以自動(dòng)執(zhí)行一個(gè)指定的方法,個(gè)人感覺這個(gè)真的很方便
一個(gè)對(duì)象可以這樣用崭庸,那么block實(shí)際也是一個(gè)對(duì)象,這樣就可以寫一個(gè)宏谊囚,實(shí)際上就是ReactiveCocoa中神奇的@onExit
#define onExit\
__strong void(^block)(void) __attribute__((cleanup(blockCleanUp), unused)) = ^
有時(shí)候我們需要用到鎖這個(gè)東西怕享,或者一些CoreFoundation的對(duì)象有時(shí)候最后需要釋放,用這個(gè)宏就很方便了
為了好看用這個(gè)宏的時(shí)候加個(gè)@就加個(gè)釋放池就可以了
Swift中:可以用defer
還有一些format, const, noreturn, aligned , packed, objc_boxable, constructor / destructor, enable_if, objc_runtime_name
可以看這兩篇文章: