iOS 9 引入了一組新的關鍵字,用來標註屬性、方法參數與方法回傳值的「空值契約」。它們只能修飾物件型別,無法修飾基本資料型別(如 int、CGFloat)。
日常自己寫程式時未必常用,但只要開始呼叫蘋果的系統 API,就會發現標頭檔裡到處都是這些標記,因此值得完整理解一次。
// 寫法一:放在屬性修飾列表中 @property (nonatomic, strong, nullable) NSString *name; // 寫法二:放在型別後方,中間有底線 @property (nonatomic, strong) NSString *_Nullable name; // 寫法三:放在型別前方 @property (nonatomic, strong) NSString *__nullable name;
non = 非,null = 空。標了 nonnull,編譯器就會在你傳入 nil 時發出警告。
@property (nonatomic, strong, nonnull) NSString *icon; @property (nonatomic, strong) NSString * _Nonnull icon; @property (nonatomic, strong) NSString * __nonnull icon;
一個省事的技巧:在 NS_ASSUME_NONNULL_BEGIN 與 NS_ASSUME_NONNULL_END 之間,所有定義的物件屬性與方法參數預設都是 nonnull,只有需要允許為空的地方才逐一標 nullable。蘋果自己的標頭檔幾乎都用這個模式,因為絕大多數參數本來就不該是 nil。
@property (nonatomic, strong, null_resettable) NSString *name; // 注意:使用 null_resettable 時,必須自行覆寫 getter 或 setter, // 攔住被設為 nil 的情況,確保 getter 永遠不會回傳 nil
這個修飾符常用在 UIColor 這類「永遠會給你一個合理預設值」的屬性上。當外部設為 nil 時,實作內部會改存一個預設顏色,因此讀取端不必處理空值。
表示「這裡到底允不允許 nil,尚未明確」,主要出現在尚未完成 nullability 標註的舊有 API 上,用於過渡相容。
@property (nonatomic, strong) NSString *_Null_unspecified name; @property (nonatomic, strong) NSString *__null_unspecified name;
寫在型別前面,例如 __kindof MyCustomClass *,語意是「回傳的是 MyCustomClass 或其任何子類」。
它的價值在於解決繼承鏈上的型別推導。舉例來說,某個 API 宣告回傳 NSArray,但你實際放進去的一定是 MyCustomClass。若宣告成 NSArray *,取值端就會拿到 NSArray 型別,還得自己轉型;宣告成 __kindof NSArray<MyCustomClass *> * 之後,呼叫端就能直接知道元素型別,不必再強轉。
反過來說,__kindof 修飾的類名既可代表當前類,也可代表其子類,這正是它比直接寫子類名更具彈性的地方。
iOS 9 同時支援輕量級泛型,兩者一起用最為靈活:
// 陣列元素型別明確,取出的物件不需要轉型 @property (nonatomic, strong, nonnull) NSArray<NSString *> *titles; // 泛型 + kindof,常見於 delegate 或工廠方法的回傳宣告 - (nonnull __kindof UIView *)makeCustomView; // 字典的 key 與 value 型別都能標註 @property (nonatomic, strong, nonnull) NSDictionary<NSString *, NSNumber *> *mapping;
總結一句:nonnull 搭配 NS_ASSUME_NONNULL_BEGIN/END 建立預設契約、nullable 標出例外、null_resettable 處理「讀必非空、寫可空」的特殊屬性、__kindof 保留子類彈性,這四個工具一起用,編譯器就能幫你攔下一整類 nil 相關的 bug。