OC: nonnull、nullable、null_resettable、__null_unspecified

当我们在查看苹果iOS各种开发框架的头文件时,在属性和方法的参数,方法的返回值的修饰中·经常会看到 nullablenonnullnull_resettablenull_unspecified等关键字
其实这几个关键字是苹果在Xcode 6.3引入的一个Objective-C的新特性:nullability annotations。在Swift中可以使用!和?来表示一个对象是optional的还是non-optional,如button?button!。而在Objective-C中则没有这一区分,button即可表示这个对象是optional,也可表示是non-optioanl。这样就会造成一个问题:在SwiftObjective-C混编时,Swift编译器并不知道一个Objective-C对象到底是optional还是non-optional,因此这种情况下编译器会隐式地将Objective-C的对象当成是non-optional。引入nullability annotations一方面为了让iOS程序员平滑地从Objective-C过渡到Swift,另一方面也促使开发者在编写Objective-C代码时更加规范,减少同事之间的沟通成本。

一: nonnull

字面意思: 不能为空(可以用来修饰属性, 或者方法的参数, 方法的返回值)

只能修饰对象,不能修饰基本数据类型

代码:

//三种使用方式都可以
@property (nonatomic, copy, nonnull) NSString *name;

@property (nonatomic, copy) NSString * _Nonnull name;

@property (nonatomic, copy) NSString * __nonnull name;

//补充(不适用于assign属性,因为它是专门用来修饰指针的)
@property (nonatomic, assign) NSUInteger age;

//补充(用下面宏包裹起来的属性全部都具nonnull特征,当然,如果其中某个属性你不希望有这个特征,也可以自己定义,比如加个nullable)
//在NS_ASSUME_NONNULL_BEGIN和NS_ASSUME_NONNULL_END之间,定义的所有对象属性和方法默认都是nonnull
//也可以在定义方法的时候使用
//返回值和参数都不能为空
- (nonnull NSString *)test:(nonnull NSString *)name;
//同上
- (NSString * _Nonnull)test1:(NSString * _Nonnull)name;

在调用这些属性或者方法的时候, 参数的类型都会带有nonnull的提示的


Nonnull区域设置(Audited Regions)
在查看苹果iOS各种开发框架的头文件时,我们发现都是用nullable修饰的属性和方法,为什么都没看到nonnull修饰的属性和方法呢?
事实上,如果需要每个属性或每个方法的参数和返回值都去指定nonnullnullable,是一件非常繁琐的事。苹果为了减轻我们的工作量,专门提供了两个宏:NS_ASSUME_NONNULL_BEGINNS_ASSUME_NONNULL_END。苹果用NS_ASSUME_NONNULL_BEGINNS_ASSUME_NONNULL_END这两个宏来统一给属性和方法参数和返回值加上nonnull修饰,NS_ASSUME_NONNULL_BEGINNS_ASSUME_NONNULL_END之间,定义的所有对象属性和方法默认都是nonnull。如UIButton的头文件,下图所示:


:

 NS_ASSUME_NONNULL_BEGIN

 - (NSString *)buyPen:( NSString *)book;
 
 NS_ASSUME_NONNULL_END

不过,为了安全起见,苹果还制定了几条规则:

  • typedef定义的类型的nullability特性通常依赖于上下文,即使是在Audited Regions中,也不能假定它为nonnull
  • 复杂的指针类型(如id *)必须显示去指定是nonnull还是nullable。例如,指定一个指向nullable对象的nonnull指针,可以使用”__nullable id * __nonnull”。
  • 我们经常使用的NSError **通常是被假定为一个指向nullable NSError对象的nullable指针。

二: nullable

字面意思: 可以为空 (使用方法和上面几乎一样, 但是好像没有上面类似的宏)

只能修饰对象,不能修饰基本数据类型

//三种使用方式
// 方式一:
@property (nonatomic, copy, nullable) NSString *name;
// 方式二:
@property (nonatomic, copy) NSString *_Nullable name;
// 方式三:
@property (nonatomic, copy) NSString *__nullable name;

三: null_resettable

get:不能返回空, set可以为空(注意:如果使用null_resettable,必须 重写get方法或者set方法,处理传递的值为空的情况)

@property (nonatomic, copy, null_resettable) NSString *name;
- (void)setName:(NSString *)name {
    if (name == nil) {
        name = @"XXX";
    }
    _name = name;
}

- (NSString *)name {
    if (_name == nil) {
        _name = @"XXX";
    }
    return _name;
}

四: _Null_unspecified

不确定是否为空

// 方式一:
 @property(nonatomic, strong) NSNumber *_Null_unspecified height;
// 方式二:
 @property(nonatomic, strong) NSNumber *__null_unspecified height;
// 方式三:
 @property(nonatomic, strong, null_unspecified) NSNumber * height;

这四个关键字在团队开发中可以为同事提示, 如果违反了规范值的要求会有警告, 很好的提高开发效率和规范!

你可能感兴趣的:(OC: nonnull、nullable、null_resettable、__null_unspecified)