当我们在查看苹果iOS各种开发框架的头文件时,在属性和方法的参数,方法的返回值的修饰中·经常会看到 nullable
,nonnull
,null_resettable
,null_unspecified
等关键字
其实这几个关键字是苹果在Xcode 6.3
引入的一个Objective-C
的新特性:nullability annotations
。在Swift
中可以使用!和?来表示一个对象是optional
的还是non-optional
,如button?
和button!
。而在Objective-C
中则没有这一区分,button
即可表示这个对象是optional
,也可表示是non-optioanl
。这样就会造成一个问题:在Swift
与Objective-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
修饰的属性和方法呢?
事实上,如果需要每个属性或每个方法的参数和返回值都去指定nonnull
和nullable
,是一件非常繁琐的事。苹果为了减轻我们的工作量,专门提供了两个宏:NS_ASSUME_NONNULL_BEGIN
和NS_ASSUME_NONNULL_END
。苹果用NS_ASSUME_NONNULL_BEGIN
,NS_ASSUME_NONNULL_END
这两个宏来统一给属性和方法参数和返回值加上nonnull
修饰,NS_ASSUME_NONNULL_BEGIN
和 NS_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;