__attribute__ 总结

attribute是GNU C特点之一,在iOS用的比较普遍.系统中有许多地方使用到. attribute能够设置函数属性（Function Attribute ）、变量属性（Variable Attribute ）和类型属性（Type Attribute)等.

函数属性(Function Attribute)

• noreturn
• noinline
• always_inline
• pure
• const
• nothrow
• sentinel
• format
• format_arg
• no_instrument_function
• section
• constructor
• destructor
• used
• unused
• deprecated
• weak
• malloc
• alias
• warn_unused_result
• nonnull

类型属性(Type Attributes)

• aligned
• packed
• transparent_union,
• unused,
• deprecated
• may_alias

变量属性(Variable Attribute)

• aligned
• packed

Clang特有的

• availability
• overloadable

书写格式

书写格式：attribute后面会紧跟一对原括弧，括弧里面是相应的attribute参数

__attribute__(xxx)

常见的系统用法

format

官方例子:NSLog

#define NS_FORMAT_FUNCTION(F,A) __attribute__((format(__NSString__, F, A)))

format属性能够给被声明的函数加上相似printf或者scanf的特征，它可使编译器检查函数声明和函数实际调用参数之间的格式化字符串是否匹配。该功能十分有用，尤为是处理一些很难发现的bug。对于format参数的使用以下
format (archetype, string-index, first-to-check)
第一参数须要传递“archetype”指定是哪一种风格,这里是 NSString；“string-index”指定传入函数的第几个参数是格式化字符串；“first-to-check”指定第一个可变参数所在的索引.

noreturn

官方例子: abort() 和 exit()

该属性通知编译器函数从不返回值。当遇到相似函数还未运行到return语句就须要退出来的状况，该属性能够避免出现错误信息。

availability

官方例子:

1. - (CGSize)sizeWithFont:(UIFont *)font NS_DEPRECATED_IOS(2_0, 7_0, "Use -sizeWithAttributes:") __TVOS_PROHIBITED;

2.  

3. //来看一下 后边的宏

4. #define NS_DEPRECATED_IOS(_iosIntro, _iosDep, ...) CF_DEPRECATED_IOS(_iosIntro, _iosDep, __VA_ARGS__)

5.  

6. define CF_DEPRECATED_IOS(_iosIntro, _iosDep, ...) __attribute__((availability(ios,introduced=_iosIntro,deprecated=_iosDep,message="" __VA_ARGS__)))

7.  

8. //宏展开之后以下

9. __attribute__((availability(ios,introduced=2_0,deprecated=7_0,message=""__VA_ARGS__)));

10. //ios便是iOS平台

11. //introduced 从哪一个版本开始使用

12. //deprecated 从哪一个版本开始弃用

13. //message 警告的消息

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

• introduced：第一次出现的版本。

• deprecated：声明要废弃的版本，意味着用户要迁移为其余API

• obsoleted： 声明移除的版本，意味着彻底移除，不再能使用它

• unavailable：在这些平台不可用

• message：一些关于废弃和移除的额外信息，clang发出警告的时候会提供这些信息，对用户使用替代的API很是有用。

• 这个属性支持的平台：ios，macosx。

简单例子:

1. //若是常常用,建议定义成相似系统的宏

2. - (void)oldMethod:(NSString *)string __attribute__((availability(ios,introduced=2_0,deprecated=7_0,message="用 -newMethod: 这个方法替代 "))){

3. NSLog(@"我是旧方法,不要调我");

4. }

5.  

6. - (void)newMethod:(NSString *)string{

7. NSLog(@"我是新方法");

8. }

效果:

Paste_Image.png

//若是调用了,会有警告

Paste_Image.png

unavailable

告诉编译器该方法不可用，若是强行调用编译器会提示错误。好比某个类在构造的时候不想直接经过init来初始化，只能经过特定的初始化方法()好比单例，就能够将init方法标记为unavailable;

1. //系统的宏,能够直接拿来用

2. #define UNAVAILABLE_ATTRIBUTE __attribute__((unavailable))

3.  

4. #define NS_UNAVAILABLE UNAVAILABLE_ATTRIBUTE

1. @interface Person : NSObject

2.  

3. @property(nonatomic,copy) NSString *name;

4.  

5. @property(nonatomic,assign) NSUInteger age;

6.  

7. - (instancetype)init NS_UNAVAILABLE;

8.  

9. - (instancetype)initWithName:(NSString *)name age:(NSUInteger)age;

10.  

11. @end

Paste_Image.png

//实际上unavailable后面能够跟参数,显示一些信息,如:

1. //系统的

2. #define NS_AUTOMATED_REFCOUNT_UNAVAILABLE __attribute__((unavailable("not available in automatic reference counting mode")))

objc_root_class

表示这个类是一个根类(基类),好比NSObject,NSProxy.

1. //摘自系统

2. //NSProxy

3. NS_ROOT_CLASS

4. @interface NSProxy <NSObject> {

5. Class isa;

6. }

7.  

8. //NSObject

9. __OSX_AVAILABLE_STARTING(__MAC_10_0, __IPHONE_2_0)

10. OBJC_ROOT_CLASS

11. OBJC_EXPORT

12. @interface NSObject <NSObject> {

13. Class isa OBJC_ISA_AVAILABILITY;

14. }

NSObject

@property (nonatomic,strong) __attribute__((NSObject)) CFDictionaryRef myDictionary;

CFDictionaryRef属于CoreFoundation框架的,也就是非OC对象,加上attribute((NSObject))后,myDictionary的内存管理会被当作OC对象来对待.

objc_designated_initializer

用来修饰类的designated initializer初始化方法，若是修饰的方法里没有调用super类的 designated initializer，编译器会发出警告。能够简写成NS_DESIGNATED_INITIALIZER

这篇文章讲的很好,建议参考这个.
https://yq.aliyun.com/articles/5847

visibility

语法:

__attribute__((visibility("visibility_type")))

其中，visibility_type 是下列值之一：

• default
  假定的符号可见性可经过其余选项进行更改。缺省可见性将覆盖此类更改。缺省可见性与外部连接对应。

• hidden
  该符号不存放在动态符号表中，所以，其余可执行文件或共享库都没法直接引用它。使用函数指针可进行间接引用。

• internal
  除非由 特定于处理器的应用二进制接口 (psABI) 指定，不然，内部可见性意味着不容许从另外一模块调用该函数。

• protected
  该符号存放在动态符号表中，但定义模块内的引用将与局部符号绑定。也就是说，另外一模块没法覆盖该符号。

• 除指定 default 可见性外，此属性均可与在这些状况下具备外部连接的声明结合使用。
  您可在 C 和 C++ 中使用此属性。在 C++ 中，还可将它应用于类型、成员函数和命名空间声明。

系统用法:

1. // UIKIT_EXTERN extern

2. #ifdef __cplusplus

3. #define UIKIT_EXTERN extern "C" __attribute__((visibility ("default")))

4. #else

5. #define UIKIT_EXTERN extern __attribute__((visibility ("default")))

6. #endif

7.  

8. `

nonnull

编译器对函数参数进行NULL的检查,参数类型必须是指针类型(包括对象)
//使用

1. - (int)addNum1:(int *)num1 num2:(int *)num2 __attribute__((nonnull (1,2))){//1,2表示第一个和第二个参数不能为空

2. return *num1 + *num2;

3. }

4.  

5. - (NSString *)getHost:(NSURL *)url __attribute__((nonnull (1))){//第一个参数不能为空

6. return url.host;

7. }

常见用法

aligned

__attribute((aligned (n)))，让所做用的结构成员对齐在n字节天然边界上。若是结构中有成员的长度大于n，则按照最大成员的长度来对齐.例如:

不加修饰的状况

1. typedef struct

2. {

3. char member1;

4. int member2;

5. short member3;

6. }Family;

7.  

8. //输出字节:

9. NSLog(@"Family size is %zd",sizeof(Family));

10. //输出结果为:

11. 2016-07-25 10:28:45.380 Study[917:436064] Family size is 12

//修改字节对齐为1

1. typedef struct

2. {

3. char member1;

4. int member2;

5. short member3;

6. }__attribute__ ((aligned (1))) Family;

7.  

8. //输出字节:

9. NSLog(@"Family size is %zd",sizeof(Family));

10. //输出结果为:

11. 2016-07-25 10:28:05.315 Study[914:435764] Family size is 12

和上面的结果一致,由于 设定的字节对齐为1.而结构体中成员的最大字节数是int 4个字节,1 < 4,按照4字节对齐,和系统默认一致.

修改字节对齐为8

1. typedef struct

2. {

3. char member1;

4. int member2;

5. short member3;

6. }__attribute__ ((aligned (8))) Family;

7.  

8. //输出字节:

9. NSLog(@"Family size is %zd",sizeof(Family));

10. //输出结果为:

11. 2016-07-25 10:28:05.315 Study[914:435764] Family size is 16

这里 8 > 4,按照8字节对齐,结果为16,不知道字节对齐的能够看个人这篇文章http://www.jianshu.com/p/f69652c7df99

但是想了半天,也不知道这玩意有什么用,设定值小于系统默认的,和没设定同样,设定大了,又浪费空间,效率也没提升,感受学习学习就好.

packed

让指定的结构结构体按照一字节对齐,测试:

1. //不加packed修饰

2. typedef struct {

3. char version;

4. int16_t sid;

5. int32_t len;

6. int64_t time;

7. } Header;

8.  

9. //计算长度

10. NSLog(@"size is %zd",sizeof(Header));

11. 输出结果为:

12. 2016-07-22 11:53:47.728 Study[14378:5523450] size is 16

能够看出,默认系统是按照4字节对齐

1. //加packed修饰

2. typedef struct {

3. char version;

4. int16_t sid;

5. int32_t len;

6. int64_t time;

7. }__attribute__ ((packed)) Header;

8.  

9. //计算长度

10. NSLog(@"size is %zd",sizeof(Header));

11. 输出结果为:

12. 2016-07-22 11:57:46.970 Study[14382:5524502] size is 15

用packed修饰后,变为1字节对齐,这个经常使用于与协议有关的网络传输中.