常用的Attributes

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

语法

一般以attribute后面加参数

1	__attribute__(xx)

下面记录一下常用的用法

1、deprecated

在编译时会报过时警告

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

2、unavailable

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

1	- (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

1	__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="iOS3-7才可以用，iOS8上不能用")));

不懂的可以参考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`

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

1
2
3

- (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的方法初始化。这句话得好好琢磨一下