空值和非空值修饰 nonnull/nullable

苹果在 Xcode 6.3 引入了一个 Objective-C 的新特性:Nullability Annotations,这一新特性的核心是两个新的类型修饰:__nullable__nonnull 。从字面上我们可知, __nullable 表示对象可以是 NULL 或 nil,而 __nonnull 表示对象不应该为空。当我们不遵循这一规则时,编译器就会给出警告。在 Xcode 7 中,为了避免与第三方库潜在的冲突,苹果把 __nonnull/__nullable改成 _Nonnull/_Nullable 。再加上苹果同样支持了没有下划线的写法 nonnull/nullable ,于是就造成现在有三种写法这样混乱的局面。
但是这三种写法本质上都是互通的,只是放的位置不同,举例如下:

  1. 方法返回值修饰
- (nullable NSString *)method;
- (NSString * __nullable)method;
- (NSString * _Nullable)method;
  1. 声明属性的修饰
@property (nullable, nonatomic, copy) NSString *aString;
@property (nonatomic, copy) NSString * __nullable aString;
@property (nonatomic, copy) NSString * _Nullable aString;
  1. 方法参数修饰
- (void)methodWithString:(nullable NSString *)aString;
- (void)methodWithString:(NSString * _Nullable)aString;
- (void)methodWithString:(NSString * __nullable)aString;
  1. 而对于 双指针类型对象Block 的返回值Block 的参数 等,这时候就不能用 nonnull/nullable 修饰,只能用带下划线的 __nonnull/__nullable 或者 _Nonnull/_Nullable
- (void)methodWithError:(NSError * _Nullable * _Nullable)error;
- (void)methodWithError:(NSError * __nullable * __null_unspecified)error;
/** nullable修饰Block可为空 */
- (void)methodWithBlock:(nullable void(^)(void))block;
- (void)methodWithBlock:(void(^ _Nullable)(void))block;
- (void)methodWithBlock:(void(^ __nullable)(void))block;
- (void)methodWithBlock:(nullable id __nonnull(^)(id __nullable params))block;
- (void)methodWithBlock:(id __nonnull(^ __nullable)(id __nullable params))block;
- (void)methodWithBlock:(id _Nonnull (^ _Nullable)(id _Nullable params))block;

总结

总结如下使用规范:

  • 对于属性、方法返回值、方法参数的修饰,使用: nonnull/nullable
  • 对于 C 函数的参数、Block 的参数、Block 返回值的修饰,使用: _Nonnull/_Nullable , 建议弃用 __nonnull/__nullable

你可能感兴趣的:(空值和非空值修饰 nonnull/nullable)