1.NS_ASSUME_NONNULL_BEGIN && NS_ASSUME_NONNULL_END
在Swift
中存在Option
类型,也就是使用?和!声明的变量。但是OC里面没有这个特征,因为在XCODE6.3之后出现新的关键词定义用于OC转SWIFT时候可以区分到底是什么类型
__nullable
&& ___nonnull
__nullable
指代对象可以为NULL或者为NIL
__nonnull
指代对象不能为null
当我们不遵循这一规则时,编译器就会给出警告。
我们来看看以下的实例,
@interface TestNullabilityClass ()
@property (nonatomic, copy) NSArray * items;
- (id)itemWithName:(NSString * __nonnull)name;
@end
@implementation TestNullabilityClass
...
- (void)testNullability {
[self itemWithName:nil]; // 编译器警告:Null passed to a callee that requires a non-null argument
}
- (id)itemWithName:(NSString * __nonnull)name {
return nil;
}
@end
事实上,在任何可以使用const
关键字的地方都可以使用__nullable
和__nonnull
,不过这两个关键字仅限于使用在指针类型上。而在方法的声明中,我们还可以使用不带下划线的nullable
和nonnull
,如下所示:
- (nullable id)itemWithName:(NSString * nonnull)name
在属性声明中,也增加了两个相应的特性,因此上例中的items属性可以如下声明:
@property (nonatomic, copy, nonnull) NSArray * items;
当然也可以用以下这种方式:
@property (nonatomic, copy) NSArray * __nonnull items;
推荐使用nonnul
l这种方式,这样可以让属性声明看起来更清晰。
Non null
区域设置(Audited Regions)
如果需要每个属性或每个方法都去指定nonnull
和nullable
,是一件非常繁琐的事。苹果为了减轻我们的工作量,专门提供了两个宏:NS_ASSUME_NONNULL_BEGIN
和NS_ASSUME_NONNULL_END
。在这两个宏之间的代码,所有简单指针对象都被假定为nonnull,因此我们只需要去指定那些nullable的指针。如下代码所示:
NS_ASSUME_NONNULL_BEGIN
@interface TestNullabilityClass ()
@property (nonatomic, copy) NSArray * items;
- (id)itemWithName:(nullable NSString *)name;
@end
NS_ASSUME_NONNULL_END
在上面的代码中,items属性默认是non null
的,itemWithName:方法的返回值也是non null
,而参数是指定为nullable
的。
不过,为了安全起见,苹果还制定了几条规则:
typedef定义的类型的nullability特性通常依赖于上下文,即使是在Audited Regions中,也不能假定它为nonnulla
。
复杂的指针类型(如id *)必须显示去指定是nonnull
还是nullable
。例如,指定一个指向nullable
对象的nonnull
指针,可以使用”
__nullable id * __nonnull
我们经常使用的NSError **
通常是被假定为一个指向nullable NSError
对象的nullable指针。
兼容性
因为Nullability Annotations是Xcode 6.3新加入的,所以我们需要考虑之前的老代码。实际上,苹果已以帮我们处理好了这种兼容问题,我们可以安全地使用它们:
老代码仍然能正常工作, 即使对nonnull
对象使用了nil也没有问题。
老代码在需要和swift混编时,在新的swift编译器下会给出一个警告。
nonnull
不会影响性能。事实上,我们仍然可以在运行时去判断我们的对象是否为nil
。
事实上,我们可以将nonnull/nullable
与我们的断言和异常一起看待,其需要处理的问题都是同一个:违反约定是一个程序员的错误。特别是,返回值是我们可控的东西,如果返回值是nonnull
的,则我们不应该返回nil
,除非是为了向后兼容。
NS_ENUM_AVAILABLE_IOS
从单词的字面可以看出使用这个宏说明这个枚举开始IOS的版本
IOS版本如下 7_0 代表7.0的版本.用_替换
参数只有一个NS_ENUM_AVAILABLE_IOS(2_0) 代表>=2.0开始
NS_ENUM_DEPRECATED_IOS
代表枚举类型已经过时的API 第一个参数是开始的时候,第二个参数是过时的时候
NS_ENUM_DEPRECATED_IOS(2_0,7_0) 代表开始于IOS2.0废弃于IOS7.0 也就是>=2.0 <=7.0
__TVOS_PROHIBITED
代表这个枚举或者类,方法,参数在TVOS系统上面不能使用
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,
} __TVOS_PROHIBITED;
UIKIT_EXTERN
extern
这个是定义字符串 变量 比#define
更加的高效 .但是UIKIT_EXTERN是根据是否是C语言宏定义,根据语言区分 ,比extern更加的高效
例子
UIKIT_EXTERN NSString *const UIApplicationInvalidInterfaceOrientationException NS_AVAILABLE_IOS(6_0) __TVOS_PROHIBITED;
上面的代码一般定义在.H 在.M实现 实现要去掉UIKIT_EXTERN.代表IOS6.0之后可以用,在TVOS系统不可用。
NS_CLASS_AVAILABLE_IOS
代表类开始的API 和上面说的类似
例子
NS_CLASS_AVAILABLE_IOS(2_0) @interface UIApplication : UIResponder
NS_EXTENSION_UNAVAILABLE_IOS
标记IOS插件不能使用这些API,后面有一个参数,可以作为提示,用什么API替换
例子
+ (UIApplication *)sharedApplication NS_EXTENSION_UNAVAILABLE_IOS("Use view controller based solutions where appropriate instead.");
__kindof
可以参考下面的连接 我就不多啰嗦了
Xcode 7新的特性Lightweight Generics 轻量级泛型与__kindof修饰符
NS_REQUIRES_SUPER
字面上必须继承父类的方法(有待考证)
SDK_HIDE_TIDE
暂定 没查到干什么的 字面上是在SDK隐藏
NS_DESIGNATED_INITIALIZER
用来定义一些初始化方法只能过来这些标记的初始化