nullable、__nullable、_Nullable 區別

蘋果在 Xcode 6.3 引入了一個 Objective-C 的新特性:Nullability Annotations,這一新特性的核心是兩個新的類型修飾:__nullable和__nonnull。從字面上我們可知,__nullable表示對象可以是 NULL 或 nil,而__nonnull表示對象不應該為空。當我們不遵循這一規則時,編譯器就會給出警告。在 Xcode 7 中,為了避免與第三方庫潛在的沖突,蘋果把__nonnull/__nullable改成_Nonnull/_Nullable。再加上蘋果同樣支持了沒有下劃線的寫法nonnull/nullable,于是就造成現在有三種寫法這樣混亂的局面。但是這三種寫法本質上都是互通的,只是放的位置不同,舉例如下:

方法返回值修飾:

- (nullableNSString*)method;- (NSString* __nullable)method;- (NSString* _Nullable)method;

聲明屬性的修飾:

@property(nonatomic,copy,nullable)NSString*aString;

@property(nonatomic,copy)NSString* __nullableaString;

@property(nonatomic,copy)NSString* _Nullable aString;

方法參數修飾:

- (void)methodWithString:(nullableNSString*)aString;- (void)methodWithString:(NSString* _Nullable)aString;- (void)methodWithString:(NSString* __nullable)aString;

而對于雙指針類型對象、Block 的返回值、Block 的參數等,這時候就不能用nonnull/nullable修飾,只能用帶下劃線的__nonnull/__nullable或者_Nonnull/_Nullable:

- (void)methodWithError:(NSError* _Nullable * _Nullable)error- (void)methodWithError:(NSError* __nullable* __null_unspecified)error;// 以及其他的組合方式

- (void)methodWithBlock:(nullablevoid(^)())block;// 注意上面的 nullable 用于修飾方法傳入的參數 Block 可以為空,而不是修飾 Block 返回值;- (void)methodWithBlock:(void(^ _Nullable)())block;- (void)methodWithBlock:(void(^ __nullable)())block;

- (void)methodWithBlock:(nullableid__nonnull(^)(id__nullableparams))block;

// 注意上面的 nullable 用于修飾方法傳入的參數 Block可以為空,而 __nonnull 用于修飾 Block 返回值 id 不能為空;

- (void)methodWithBlock:(id__nonnull(^ __nullable)(id__nullableparams))block;

- (void)methodWithBlock:(id_Nonnull (^ _Nullable)(id_Nullable params))block;

// the method accepts a nullable blockthat returns a nonnullvalue

// therearesomemore combinations here, yougetthe idea

以上基本上羅列了絕大部分的使用場景,但看完我們還是一臉懵逼啊,仍然不清楚什么時候應該用哪個修飾符!

在看了原生 iOS SDK 里 Foundation 和 UIKit 的頭文件以及蘋果的博文《Nullability and Objective-C》,我們總結如下使用規范:

對于屬性、方法返回值、方法參數的修飾,使用:nonnull/nullable;

對于 C 函數的參數、Block 的參數、Block 返回值的修飾,使用:_Nonnull/_Nullable,建議棄用__nonnull/__nullable

Nonnull Audited Regions

如果需要每個屬性或每個方法都去指定nonnull和nullable,將是一件非常繁瑣的事。蘋果為了減輕我們的工作量,專門提供了兩個宏:NS_ASSUME_NONNULL_BEGIN和NS_ASSUME_NONNULL_END。在這兩個宏之間的代碼,所有簡單指針對象都被假定為nonnull,因此我們只需要去指定那些nullable指針對象即可。如下代碼所示:

NS_ASSUME_NONNULL_BEGIN

@interfacemyClass()

@property(nonatomic,copy)NSString*aString;

-(id)methodWithString:(nullableNSString*)str;

@end

NS_ASSUME_NONNULL_END

在上面的代碼中,aString屬性默認是nonnull的,methodWithString:方法的返回值也是nonnull,而方法的參數str被顯式指定為nullable。

不過,為了安全起見,蘋果還制定了以下幾條規則:

通過typedef定義的類型的nullability特性通常依賴于上下文,即使是在 Audited Regions 中,也不能假定它為nonnull;

對于復雜的指針類型(如id *)必須顯式去指定是nonnull還是nullable。例如,指定一個指向nullable對象的nonnull指針,可以使用__nullable id * __nonnull;

我們經常使用的NSError **通常是被假定為一個指向nullableNSError 對象的nullable指針。

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

推薦閱讀更多精彩內容