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

生命是什么呢?生命是時(shí)時(shí)刻刻不知如何是好辐马。

nullable 與 nonnull 的區(qū)別

__nullable:表示對(duì)象可以是 NULL 或者 nil令宿。

__nonnull:表示對(duì)象不可以為空悲酷。

__null_unspecified:表示對(duì)象未指定岩臣、不明確烈评。

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

在 Xcode 7 中乱凿,為了避免與第三方庫(kù)的沖突顽素,Apple 把 __nullable / __nonnull 改成了 _Nullable/_Nonnull咽弦,也支持沒(méi)有下劃線的寫(xiě)法:nullable / nonnull徒蟆。

使用規(guī)范:

  1. 對(duì)于屬性、方法返回值型型、方法參數(shù)的修飾段审,使用 nonnull/nullable
  2. 對(duì)于 C 函數(shù)的參數(shù)闹蒜、Block 的參數(shù)寺枉、Block 返回值的修飾抑淫,使用 _Nonnull/_Nullable,建議棄用 __nonnull/__nullable

為安全起見(jiàn)姥闪,Apple 制定的使用規(guī)則:

  1. 通過(guò) typedef 定義的類型的 nullability 特性通常依賴于上下文始苇,即使是在 Audited Regions 中,也不能假定它為 nonnull 筐喳;
  2. 對(duì)于復(fù)雜的指針類型(如 id * )必須顯式去指定是 nonnull 還是 nullable催式。例如,指定一個(gè)指向 nullable 對(duì)象的 nonnull 指針避归,可以使用 __nullable id * __nonnul 荣月;
  3. 我們經(jīng)常使用的 NSError ** 通常是被假定為一個(gè)指向 nullable NSError 對(duì)象的 nullable 指針。

使用區(qū)別

共有三種用法:

  • nonnull梳毙,nullable, null_unspecified
  • _Nonnull哺窄,_Nullable_Null_unspecified账锹,
  • __nonnull萌业,__nullable__null_unspecified奸柬。

這幾種用法在聲明時(shí)的位置區(qū)別:

  1. 單下劃線和雙下劃線的需要放在類型定義之后咽白。
  2. 無(wú)下劃線的需要放在類型定義之前。

使用示例:

聲明屬性

@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;

修飾方法參數(shù)

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

例外情況

??雙指針類型對(duì)象鸟缕、Block 的返回值晶框、Block 的傳入?yún)?shù)等,不能用 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 修飾的是方法傳入?yún)?shù),表示傳入的 Block 可以為空番甩,而不是修飾 BlocK 返回值侵贵。

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

Block 傳入?yún)?shù)

- (void)methodWithBlock21:(nullable id nonnull(^)(id nullable parameters))block;
// ?? 以上 nullable 修飾的是方法傳入?yún)?shù),表示傳入的 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>

// 在這兩個(gè)宏之間的代碼,所有簡(jiǎn)單指針對(duì)象都被假定為 nonnull 宴胧,因此我們只需要去指定那些 nullable 指針對(duì)象即可漱抓。
NS_ASSUME_NONNULL_BEGIN

@interface MyObject : NSObject

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

// 方法返回值默認(rèn)為 nonnull
// 方法的參數(shù)顯式聲明為 nullabel,表示入?yún)⒖梢詾榭?- (id)methodWithString:(nullable NSString *)string;

@end

NS_ASSUME_NONNULL_END

參考

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市恕齐,隨后出現(xiàn)的幾起案子乞娄,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,252評(píng)論 6 516
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件仪或,死亡現(xiàn)場(chǎng)離奇詭異确镊,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)范删,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,886評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門(mén)蕾域,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人到旦,你說(shuō)我怎么就攤上這事束铭。” “怎么了厢绝?”我有些...
    開(kāi)封第一講書(shū)人閱讀 168,814評(píng)論 0 361
  • 文/不壞的土叔 我叫張陵契沫,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我昔汉,道長(zhǎng)懈万,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 59,869評(píng)論 1 299
  • 正文 為了忘掉前任靶病,我火速辦了婚禮会通,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘娄周。我一直安慰自己涕侈,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,888評(píng)論 6 398
  • 文/花漫 我一把揭開(kāi)白布煤辨。 她就那樣靜靜地躺著裳涛,像睡著了一般。 火紅的嫁衣襯著肌膚如雪众辨。 梳的紋絲不亂的頭發(fā)上端三,一...
    開(kāi)封第一講書(shū)人閱讀 52,475評(píng)論 1 312
  • 那天,我揣著相機(jī)與錄音鹃彻,去河邊找鬼郊闯。 笑死,一個(gè)胖子當(dāng)著我的面吹牛蛛株,可吹牛的內(nèi)容都是我干的团赁。 我是一名探鬼主播,決...
    沈念sama閱讀 41,010評(píng)論 3 422
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼谨履,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼欢摄!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起屉符,我...
    開(kāi)封第一講書(shū)人閱讀 39,924評(píng)論 0 277
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤剧浸,失蹤者是張志新(化名)和其女友劉穎锹引,沒(méi)想到半個(gè)月后矗钟,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體唆香,經(jīng)...
    沈念sama閱讀 46,469評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,552評(píng)論 3 342
  • 正文 我和宋清朗相戀三年吨艇,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了躬它。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,680評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡东涡,死狀恐怖冯吓,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情疮跑,我是刑警寧澤组贺,帶...
    沈念sama閱讀 36,362評(píng)論 5 351
  • 正文 年R本政府宣布,位于F島的核電站祖娘,受9級(jí)特大地震影響失尖,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜渐苏,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,037評(píng)論 3 335
  • 文/蒙蒙 一掀潮、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧琼富,春花似錦仪吧、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 32,519評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至械蹋,卻和暖如春人断,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背朝蜘。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,621評(píng)論 1 274
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留暇仲,地道東北人副渴。 一個(gè)月前我還...
    沈念sama閱讀 49,099評(píng)論 3 378
  • 正文 我出身青樓煮剧,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親佑颇。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,691評(píng)論 2 361