Clang Language Extensions

2023-02-14 22:12:21

Xcode

本文是自《Clang Language Extensions》中选取部分与 Objective-C 相关的内容翻译，由于作者水平有限，如存在理解错误或翻译不到位的地方，还请指正！

特性检查宏（Feature Checking Macros）

__has_builtin

此函数类型的宏传递一个函数名作为参数来判断该函数是否为内置函数。

#ifndef __has_builtin         // Optional of course.

  #define __has_builtin(x) 0  // Compatibility with non-clang compilers.

#endif

#if __has_builtin(__builtin_trap)

  __builtin_trap();

#else

  abort();

#endif

__has_feature & __has_extension

这两个函数类型的宏传递一个特性的名称作为参数，如果该特性同时被 Clang 和当前语言的标准所支持，__has_feature返回 1，否则返回 0。如果该特性被 Clang 和当前语言（不管是该语言的扩展还是标准）所支持，__has_extension返回 1，否则返回 0。

#ifndef __has_feature         // Optional of course.

  #define __has_feature(x) 0  // Compatibility with non-clang compilers.

#endif

#ifndef __has_extension

  #define __has_extension __has_feature // Compatibility with pre-3.0 compilers.

#endif

#if __has_feature(objc_arc)

        NSLog(@"under ARC");

#endif

#if __has_extension(blocks)

        NSLog(@"support blocks");

#endif

出于向后兼容的考虑，__has_feature也可以用来检查非标准语法特性，如：不是以c_、cxx_、objc_等为前缀的特性。所以用__has_feature(blocks)来检查是否支持 block 也是可以的。如果设置-pedantic-errors选项，__has_extension和__has_feature作用就是一样的。

__has_attribute

此宏传递一个属性名称用于检查该属性是否被支持。

#ifndef __has_attribute         // Optional of course.

  #define __has_attribute(x) 0  // Compatibility with non-clang compilers.

#endif

#if __has_attribute(always_inline)

  #define ALWAYS_INLINE __attribute__((always_inline))

#else

  #define ALWAYS_INLINE

#endif

传入的属性名也可以采用前后加__（下划线）的命名方式来防止命名冲突，所以这里__always_inline__和always_inline是等价的。

文件引入检查宏（Include File Checking Macros）

并不是所有的系统都一定包含你所需要引入的文件，所以你可以使用__has_include和__has_include_next宏在你#include之前检查你所需要引入的文件在当前系统是否存在。

__has_include

此宏传入一个你想引入文件的名称作为参数，如果该文件能够被引入则返回 1，否则返回 0。

// Note the two possible file name string formats.

#if __has_include("myinclude.h") && __has_include(<stdint.h>)

#include "myinclude.h"

#endif

为了兼容非 clang 编译器，你可以这样写：

// To avoid problem with non-clang compilers not having this macro.

#if defined(__has_include)

  #if __has_include("myinclude.h")

    #include "myinclude.h"

  #endif

#endif

__has_include_next

此宏与__has_include功能相似，只不过会判断引入包含该文件的后面一个路径下的文件是否可引入。

// Note the two possible file name string formats.

#if __has_include_next("myinclude.h") && __has_include_next(<stdint.h>)

# include_next "myinclude.h"

#endif

// To avoid problem with non-clang compilers not having this macro.

#if defined(__has_include_next)

#if __has_include_next("myinclude.h")

# include_next "myinclude.h"

#endif

#endif

__has_include_next和 GNU 扩展语句#include_next一样，只能在头文件中使用，如果在其他的位置使用会引起警告。

__has_warning

此宏传入一个字符串作为参数，该字符串表示一种警告类型，如果该警告有效返回 true。

#if __has_warning("-Wformat")

...

#endif

内置宏（Builtin Macros）

__BASE_FILE__
返回当前文件的路径。

__COUNTER__
计数器，初始值为 0，每次使用__COUNTER__时都会自动 +1。（以文件为计数单元，即不同文件中的__COUNTER__值是独立计数的）

__INCLUDE_LEVEL__
当前文件被引用的深度，main 文件时该值为 0。

__TIMESTAMP__
返回当前文件最后一次修改的时间戳。

__clang__
布尔值，返回当前编译器是否支持 clang。

__clang_major__
返回当前 Clang 的主版本号（如 version4.6.3 中的 4）。

__clang_minor__
返回当前 Clang 的次版本号（如 version4.6.3 中的 6）。

__clang_patchlevel__
返回当前 Clang 的补丁版本号（如 version4.6.3 中的 3）。

__clang_version__
返回当前 Clang 的完整的版本号。

if (__clang__) {

    NSLog(@"__BASE_FILE__: %s", __BASE_FILE__);

    NSLog(@"__COUNTER__: %d", __COUNTER__);

    NSLog(@"__COUNTER__: %d", __COUNTER__);

    NSLog(@"__COUNTER__: %d", __COUNTER__);

    NSLog(@"__TIMESTAMP__: %s", __TIMESTAMP__);

    NSLog(@"__INCLUDE_LEVEL__: %d", __INCLUDE_LEVEL__);

    NSLog(@"__clang_major__: %d", __clang_major__);

    NSLog(@"__clang_minor__: %d", __clang_minor__);

    NSLog(@"__clang_patchlevel__: %d", __clang_patchlevel__);

    NSLog(@"__clang_version__: %s", __clang_version__);

}

/*

__BASE_FILE__: /Users/tracy/Desktop/Clang/Clang/main.m

__COUNTER__: 0

__COUNTER__: 1

__COUNTER__: 2

__TIMESTAMP__: Fri Jul 26 14:24:35 2013

__INCLUDE_LEVEL__: 0

__clang_major__: 5

__clang_minor__: 0

__clang_patchlevel__: 0

__clang_version__: 5.0 (clang-500.1.65)

 */

除了以上几个宏之外，还有两个是我们经常会用到了__FUNCTION__和__LINE__，分别返回当前代码段所在的函数名和在当前文件中的行数，这个在打印 log 时比较有用。

带 deprecated 和 unavailable 属性的方法

方法或属性可以加上带deprecated或unavilable等属性来表示状态。如：

void explode(void) __attribute__((deprecated("extremely unsafe, use 'combust' instead!!!")));

如果一个方法被标记为deprecated，在使用时会有警告，如果是unavilable则会报错。

在 iOS 和 OS X 中，苹果也是使用该方法__attribute__进行 API 版本控制，只不过通常使用availability属性。

带属性的枚举类型（Attributes on Enumerators）

Clang 允许给枚举值添加属性来标记某些枚举项是否可选。如：

enum OperationMode {

  OM_Invalid,

  OM_Normal,

  OM_Terrified __attribute__((deprecated)),

  OM_AbortOnError __attribute__((deprecated)) = 4

};

在 iOS7 SDK 中 UIStatusBarStyle 的定义如下：

typedef NS_ENUM(NSInteger, UIStatusBarStyle) {

    UIStatusBarStyleDefault                                     = 0, // Dark content, for use on light backgrounds

    UIStatusBarStyleLightContent     NS_ENUM_AVAILABLE_IOS(7_0) = 1, // Light content, for use on dark backgrounds

    UIStatusBarStyleBlackTranslucent NS_ENUM_DEPRECATED_IOS(2_0, 7_0, "Use UIStatusBarStyleLightContent") = 1,

    UIStatusBarStyleBlackOpaque      NS_ENUM_DEPRECATED_IOS(2_0, 7_0, "Use UIStatusBarStyleLightContent") = 2,

};

其中NS_ENUM_AVAILABLE_IOS和NS_ENUM_DEPRECATED_IOS本质上也是使用的__attribute__()。

availability 属性

Clang 提供了availability属性来描述申明对象的生命周期，如：

void f(void) __attribute__((availability(ios,introduced=4.0,deprecated=6.0,obsoleted=7.0)));

表明函数 f 在 iOS4.0 时被引入，在 6.0 是就不推荐使用，到 iOS7.0 就彻底废弃。

在方法重载的时候，子类的方法可以比父类的方法申明更大的有效范围：

@interface A

- (id)method __attribute__((availability(macosx,introduced=10.6)));

- (id)method2 __attribute__((availability(macosx,introduced=10.6)));

@end

@interface B : A

- (id)method __attribute__((availability(macosx,introduced=10.4))); //okay: method moved into base class later

- (id)method2 __attribute__((availability)(macosx,introduced=10.8)); //error: this method was available via the base class in 10.6

@end

Objective-C 相关特性

自动引用计数（ARC）

Clang 提供了对 Objective-C 中自动引用计数的支持，这样你就不需要手动调用retain/release/autorelease等方法。与自动引用计数相关有两个宏可用：__has_feature(objc_arc)用来判断当前环境是否是 ARC，__has_feature(objc_arc_weak)用来判断weak和__weak关键字是否可用。

对象字面量和下标

Clang 提供了对 Objective-C 中对象字面量和下标的支持，这些简化了 Objective-C 编码方式，让程序更简洁。有几个宏与此相关：__has_feature(objc_array_literals)判断数组字面量是否支持，__has_feature(objc_dictionary_literals)判断字典字面量是否支持，__has_feature(objc_subscripting)判断对象下标是否支持。

Objective-C 属性自动合成

Clang 支持声明的属性自动合成，也就是只需要申明属性@property NSString *name;，就会自动为 _name 生产 get/set 方法。__has_feature(objc_default_synthesize_properties)可以检查属性自动合成在当前版本的 Clang 下是否支持。

objc_method_family 属性

在 Objective-C 中方法的命名通常代表着方法类型，如以init开头的方法会被编译器默认为是初始化方法，在编译的时候会将该方法当成初始化方法对待。但是有时候我们并不想以编译器默认的方式给方法取名，或者编译器默认的方法类型与我们自己想表示的有出入。我们就可以使用__attribute__((objc_method_family(X)))来明确说明该方法的类型，其中 X 取值为：none,alloc,copy,init,mutableCopy,new。如：

- (NSString *)initMyStringValue __attribute__((objc_method_family(none)));

这样该方法在编译时就不会再被编译器当做为初始化方法了。

Objective-C 对象引用属性

在 Objective-C 中，方法通常是遵循Cocoa Memory Management规范来对参数和返回值进行内存管理的。但是会有特许的情况，所以 Clang 提供了属性来标识对象引用情况。

使用 ns_returns_retained,ns_returns_not_retained,ns_returns_autoreleased,cf_returns_retained,cf_returns_not_retained等属性来说明方法中对返回值引用的情况。

id foo() __attribute__((ns_returns_retained));

- (NSString *)bar:(int)x __attribute__((ns_returns_autoreleased));

标记为*_returns_retained属性的返回的对象引用计数 +1 了，*_returns_not_retained属性标记的返回对象引用计数前后没有改变，*_returns_autorelased属性标记的返回对象引用计数 +0，但是会在下一个自动释放池中被释放掉。

使用 ns_cousumed和cf_consumed属性来标记在方法中会被 +1 的参数，ns_consumes_self属性在 Objective-C 方法中使用，标记在该方法中 self 对象的引用计数会被 +1。

void foo(__attribute__((ns_consumed) NSString *string);

- (void)bar __attribute__((ns_consumed_self));

- (void)baz:(id) __attribute__((ns_consumed)) x;

你可以使用__has_feature()方法判断这些属性是否可用。

Posted by TracyYih - 7月 26 2013
如需转载，请注明：本文来自 Esoft Mobile

码农公寓

Clang Language Extensions

特性检查宏（Feature Checking Macros）

__has_builtin

__has_feature & __has_extension

__has_attribute

文件引入检查宏（Include File Checking Macros）

__has_include

__has_include_next

__has_warning

内置宏（Builtin Macros）

带 deprecated 和 unavailable 属性的方法

带属性的枚举类型（Attributes on Enumerators）

availability 属性

Objective-C 相关特性

相关返回类型（related result types）

自动引用计数（ARC）

对象字面量和下标

Objective-C 属性自动合成

objc_method_family 属性

Objective-C 对象引用属性

码农公寓

特性检查宏（Feature Checking Macros）

__has_builtin

__has_feature & __has_extension

__has_attribute

文件引入检查宏（Include File Checking Macros）

__has_include

__has_include_next

__has_warning

内置宏（Builtin Macros）

带 deprecated 和 unavailable 属性的方法

带属性的枚举类型（Attributes on Enumerators）

availability 属性

Objective-C 相关特性

相关返回类型（related result types）

自动引用计数（ARC）

对象字面量和下标

Objective-C 属性自动合成

objc_method_family 属性

Objective-C 对象引用属性

相关文章