Objective-C 編程:nullable 與 nonnull 的使用

生命是什么呢?生命是時時刻刻不知如何是好。

nullable 與 nonnull 的區別

__nullable:表示對象可以是 NULL 或者 nil。

__nonnull:表示對象不可以為空。

__null_unspecified:表示對象未指定、不明確。

如果沒有顯式聲明,則表示 __nonnull 或者_Null_unspecified (不明確)

在 Xcode 7 中,為了避免與第三方庫的沖突,Apple 把 __nullable / __nonnull 改成了 _Nullable/_Nonnull,也支持沒有下劃線的寫法:nullable / nonnull

使用規范:

  1. 對于屬性、方法返回值、方法參數的修飾,使用 nonnull/nullable
  2. 對于 C 函數的參數、Block 的參數、Block 返回值的修飾,使用 _Nonnull/_Nullable,建議棄用 __nonnull/__nullable

為安全起見,Apple 制定的使用規則:

  1. 通過 typedef 定義的類型的 nullability 特性通常依賴于上下文,即使是在 Audited Regions 中,也不能假定它為 nonnull
  2. 對于復雜的指針類型(如 id * )必須顯式去指定是 nonnull 還是 nullable。例如,指定一個指向 nullable 對象的 nonnull 指針,可以使用 __nullable id * __nonnul
  3. 我們經常使用的 NSError ** 通常是被假定為一個指向 nullable NSError 對象的 nullable 指針。

使用區別

共有三種用法:

  • nonnullnullable, null_unspecified
  • _Nonnull_Nullable_Null_unspecified
  • __nonnull__nullable__null_unspecified

這幾種用法在聲明時的位置區別:

  1. 單下劃線和雙下劃線的需要放在類型定義之后。
  2. 無下劃線的需要放在類型定義之前。

使用示例:

聲明屬性

@property (nonatomic, copy, nullable) NSString *name;
@property (nonatomic, copy) NSString *__nullable firstName;
@property (nonatomic, copy) NSString *_Nullable lastName;

修飾方法返回值

- (nullable NSString *)method1;
- (NSString *__nullable)method2;
- (NSString *_Nullable)method3;

修飾方法參數

- (void)methodWithString1:(nullable NSString *)aString;
- (void)methodWithString2:(NSString *__nullable)aString;
- (void)methodWithString3:(NSString *_Nullable)aString;

例外情況

??雙指針類型對象、Block 的返回值、Block 的傳入參數等,不能用 nonnull/nullable 修飾,只能用帶下劃線的 __nonnull/__nullable 或者 _Nonnull/_Nullable

- (void)methodwithError1:(NSError * _Nullable * __null_unspecified)error;
- (void)methodwithError2:(NSError * nullable * null_unspecified)error;

Block 返回值

- (void)methodWithBlock1:(nullable void(^)(void))block;
// ?? 以上 nullable 修飾的是方法傳入參數,表示傳入的 Block 可以為空,而不是修飾 BlocK 返回值。

- (void)methodWithBlock2:(void (^ _Nullable)(void))block;
- (void)methodWithBlock3:(void (^ __nullable)(void))block;

Block 傳入參數

- (void)methodWithBlock21:(nullable id nonnull(^)(id nullable parameters))block;
// ?? 以上 nullable 修飾的是方法傳入參數,表示傳入的 BlocK 可以為空。而 __nonnull 用于修飾 Block 返回值 id 不能為空。

- (void)methodWithBlock22:(id  nonnull(^ nullable)(id _Nullable parameters))block;
- (void)methodWithBlock23:(id  _Nonnull (^ _Nonnull)(id _Nullable parameters))block;

宏 NS_ASSUME_NONNULL_BEGIN 與 NS_ASSUME_NONNULL_END

#import <Foundation/Foundation.h>

// 在這兩個宏之間的代碼,所有簡單指針對象都被假定為 nonnull ,因此我們只需要去指定那些 nullable 指針對象即可。
NS_ASSUME_NONNULL_BEGIN

@interface MyObject : NSObject

// 默認為 nonnull
@property (nonatomic, copy) NSString *aString;

// 方法返回值默認為 nonnull
// 方法的參數顯式聲明為 nullabel,表示入參可以為空
- (id)methodWithString:(nullable NSString *)string;

@end

NS_ASSUME_NONNULL_END

參考

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,197評論 6 531
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,415評論 3 415
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,104評論 0 373
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 62,884評論 1 309
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,647評論 6 408
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,130評論 1 323
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,208評論 3 441
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,366評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,887評論 1 334
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,737評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,939評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,478評論 5 358
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,174評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,586評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,827評論 1 283
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,608評論 3 390
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,914評論 2 372