iOS中常用的Attribute

昨天看了YYCache的源码,发现里面经常用到了__attribute__attribute是GNU的一种编译指令在声明的时候指定某种特性,能做多样化的错误检查和高级优化。在iOS的系统库里面会经常用到,例如:NS_AVAILABLE_IOS(8_0)展开来就是__attribute__(availability(...))

语法

一般以attribute后面加参数

__attribute__(xx)

下面记录一下常用的用法

1、deprecated

在编译时会报过时警告

- (void)method1:( NSString *)string __attribute__((deprecated("使用#method2")));
- (void)method12 DEPRECATED_ATTRIBUTE; //DEPRECATED_ATTRIBUTE是系统的宏

2、unavailable

告诉编译器方法不可用,如果使用了就会编译失败,提示错误。比如自定义了初始化方法,为了防止别人调用init初始化,那么可以这样:

    - (instancetype)init NS_UNAVAILABLE; 

也可以像下面以不同的姿势

    @property (strong,nonatomic) id var1 NS_UNAVAILABLE;
    - (void)method9 NS_UNAVAILABLE;
    - (void)method10 UNAVAILABLE_ATTRIBUTE;
    - (void)method11 __attribute__((unavailable("不能用,不能用,不能用")));

3、cleanup

它主要作用于变量,当变量的作用域结束时,会调用指定的函数。这个属性用得好,简直是爽得不要不要的。
先看一下,自定义的类型:

- (void)createXcode{
    NSObject *xcode __attribute__((cleanup(xcodeCleanUp))) = [NSObject new];
    NSLog(@"%@",xcode);
}

// 指定一个cleanup方法,注意入参是所修饰变量的地址,类型要一样
// 对于指向objc对象的指针(id *),如果不强制声明__strong默认是__autoreleasing,造成类型不匹配
static void xcodeCleanUp(__strong NSObject **xcode){
    NSLog(@"cleanUp call %@",*xcode);
}

当然Block也是变量,所以写一个block的来试试

- (void)createBlock{
    __strong void(^block)() __attribute__((cleanup(blockCleanup))) = ^{
        NSLog(@"Call Block");
    };
}

static void blockCleanup(__strong void(^*block)(void)){
    (*block)();
}

是不是觉得很有趣呢?更多深入可以看一下黑魔法attribute((cleanup))

4、availability

这个参数是指定变量(方法)的使用版本范围,这个很好用。
拿一下官方的作为例子,UITableViewCell里面找的

    NS_DEPRECATED_IOS(2_0, 3_0)
     
    #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__)))

上面定义的NS_DEPRECATED_IOS(2_0, 3_0)展开为attribute

    __attribute__((availability(ios,introduced=2_0,deprecated=3_0,message="" __VA_ARGS__)))

availability属性是一个以逗号为分隔的参数列表,以平台的名称开始,包含一些放在附加信息里的一些里程碑式的声明。

  • introduced:第一次出现的版本。
  • deprecated:声明要废弃的版本,意味着用户要迁移为其他API
  • obsoleted: 声明移除的版本,意味着完全移除,再也不能使用它
  • unavailable:在这些平台都不可用
  • message 一些关于废弃和移除的信息
  • 属性支持的平台:iOS , macosx(我看了一下系统的宏,现在有swift关键字了)

Show you the Code

- (void)method4 NS_DEPRECATED_IOS(2_0, 3_0,"不推荐这个方法");
- (void)method5 CF_DEPRECATED_IOS(4_0, 5_0,"不推荐就不推荐");
- (void)method6 __attribute__((availability(ios,introduced=3_0,deprecated=7_0,message="3-7才推荐使用")));
- (void)method7 __attribute__((availability(ios,unavailable,message="iOS平台你用个屁啊")));
- (void)method8 __attribute__((availability(ios,introduced=3_0,deprecated=7_0,obsoleted=8_0,message="3-7才可以用,8平台上不能用")));

不懂的可以参考CFAvailability.h这个文件

5、overloadable

这个属性用在C的函数上实现像java一样方法重载。直接上主菜:

__attribute__((overloadable)) void add(int num){
    NSLog(@"Add Int %i",num);
}

__attribute__((overloadable)) void add(NSString * num){
    NSLog(@"Add NSString %@",num);
}

__attribute__((overloadable)) void add(NSNumber * num){
    NSLog(@"Add NSNumber %@",num);
}

6、 objc_designated_initializer

这个属性是指定内部实现的初始化方法。

- (instancetype)initNoDesignated ;
- (instancetype)initNoDesignated12 NS_DESIGNATED_INITIALIZER;
- (instancetype)initDesignated NS_DESIGNATED_INITIALIZER;

上面的NS_DESIGNATED_INITIALIZER展开就是:__attribute__((objc_designated_initializer))

当一个类存在方法带有NS_DESIGNATED_INITIALIZER属性时,它的NS_DESIGNATED_INITIALIZER方法必须调用super的NS_DESIGNATED_INITIALIZER方法。它的其他方法(非NS_DESIGNATED_INITIALIZER)只能调用self的方法初始化。这句话得好好琢磨一下

7、objc_subclassing_restricted

这个顾名思义就是相当于java的final关键字了,意是说它不能有子类。用于类

__attribute__((objc_subclassing_restricted)) //Final类 ,java的final关键字
@interface CustomObject : NSObject  

如果有子类继承他的话,就会报错

8、objc_requires_super

这个也挺有意思的,意思是子类重写这个方法的时候,必须调用[super xxx]

    #define NS_REQUIRES_SUPER __attribute__((objc_requires_super))
    - (void)method2 __attribute__((objc_requires_super));

暂时就说这么多,我认为比较常用的吧。还有很多可以参考下面的文档

attribute

attribute 总结

Clang Attributes 黑魔法小记

Clang 3.8 documentation

Source Annotations

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容