您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

Clang 警告透解:可空值被強轉為不可空值

編輯:iOS 開發基礎

  • 本文由 CocoaChina 譯者星夜暮晨翻譯

  • 原文:CLANG WARN NULLABLE TO NONNULL CONVERSION

Xcode 7 引入了一個名為「Apple LLVM 7.0 - Warnings - All languages > Incorrect Uses of Nullable Values」的編譯選項,其配置鍵為 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION。

你也可以通過編譯標志 -Wnullable-to-nonnull-conversion 來開啟它。

它究竟做什麼?

為便於說明,先看一個命令行小例子:

#import
void welcomeToClowntown(NSString *_Nonnull greeting) {
    NSLog(@"%@, welcome to clowntown!", greeting);
}
int main(int argc, const char * argv[]) {
    // Warning: Null passed to a callee that requires a non-null argument
    welcomeToClowntown(nil);
    return 0;
}

注意,我們向 welcomeToClowntown() 傳入了 nil 字面量,而它的參數類型是 NSString *_Nonnull。無論 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION 是否開啟,這都會觸發警告。

那下面這個例子呢?

#import
void welcomeToClowntown(NSString *_Nonnull greeting) {
    NSLog(@"%@, welcome to clowntown!", greeting);
}
NSString *_Nullable clownyGreeting() {
    if (arc4random() % 2 == 0) {
        return @"Hola";
    } else {
        return nil;
    }
}
int main(int argc, const char * argv[]) {
    // *只有*在 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION 開啟時才會警告
    // Warning: Implicit conversion from nullable pointer
    //  'NSString * _Nullable' to non-nullable pointer type 'NSString * _Nonnull'
    welcomeToClowntown(clownyGreeting());
    return 0;
}

welcomeToClowntown() 需要一個 NSString *_Nonnull 參數,但我們傳入的卻是 clownyGreeting() 的返回值,其類型為 NSString *_Nullable。換句話說,我們給一個要求非空的函數傳了一個可能為 nil 的值。這正是 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION 要捕捉並警告的場景。

何時該開啟它?

我建議在往 Objective-C 頭文件中添加可空標識符之前,先打開這個選項。這樣一來,只要你為接口加上了「不可空」的限制,一旦有代碼違反,編譯器就會及時告警。

它是否萬無一失?

並非如此。和大多數編譯器警告一樣,它可以被繞過:

#import
void welcomeToClowntown(NSString *_Nonnull greeting) {
    NSLog(@"%@, welcome to clowntown!", greeting);
}
NSString *_Nullable clownyGreeting() {
    if (arc4random() % 2 == 0) {
        return @"Hola";
    } else {
        return nil;
    }
}
int main(int argc, const char * argv[]) {
    // 不再觸發警告,因為返回值被「強轉」成了一個
    //(未明確聲明可空性的)`NSString *` 類型
    NSString *greeting = clownyGreeting();
    welcomeToClowntown(greeting);
    return 0;
}

當我們把 clownyGreeting() 的返回值先賦給一個 NSString * 類型的變量時,編譯器就不再報警了。我理解這是因為返回的 NSString *_Nonnull 被「強轉」成了 NSString *,而後者並未明確標注是否可空。

為什麼有人不建議開啟它?

可空標識符被添加進了 NSString 等諸多 Foundation 類,其中某些標註相當嚴格。比如 -[NSString isEqualToString:] 的參數就是 NSString *_Nonnull。如果你的代碼裡有大量調用點,並期望在傳入 nil 時 -isEqualToString: 返回 NO(比如解析 JSON 時常遇到),那就不得不去修改這些調用點來消除惱人的警告。

#import
NSString *_Nullable clownyGreeting() {
    if (arc4random() % 2 == 0) {
        return @"Hola";
    } else {
        return nil;
    }
}
int main(int argc, const char * argv[]) {
    // *只有*在 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION 開啟時才會警告
    // Warning: Implicit conversion from nullable pointer
    //  'NSString * _Nullable' to non-nullable pointer type 'NSString * _Nonnull'
    [@"Hola" isEqualToString:clownyGreeting()];
    return 0;
}

這會讓編碼變得更繁瑣。因此提醒一句:在項目中開啟 CLANG_WARN_NULLABLE_TO_NONNULL_CONVERSION,可能會瞬間冒出大量警告!

不過,這些指向 nil 的潛在隱患,說不定正散落在你系統的各個角落。不妨把這個選項打開,親眼看看那些令人吃驚的結果吧!

感謝 @nlutsenko 為我介紹了這個設置項!

更新:Clang 靜態分析器的改進

最新版的 Clang 靜態分析器於 2015 年 10 月 28 日發布,它能捕捉到我上面指出的那個「可規避點」:

#import
void welcomeToClowntown(NSString *_Nonnull greeting) {
    NSLog(@"%@, welcome to clowntown!", greeting);
}
NSString *_Nullable clownyGreeting() {
    if (arc4random() % 2 == 0) {
        return @"Hola";
    } else {
        return nil;
    }
}
int main(int argc, const char * argv[]) {
    // 此前不會警告,因為返回值被「強轉」成了一個
    //(未明確聲明可空性的)`NSString *` 類型
    //
    // 最新的 Clang 靜態分析器則會警告:
    // Warning: Nullable pointer is passed to a callee that requires a non-null argument
    NSString *greeting = clownyGreeting();
    welcomeToClowntown(greeting);
    return 0;
}

這是一項極大的改進,我已迫不及待想在 Xcode 中用上這個新分析器。當然,你也可以下載最新版本,運行下面的命令自行體驗:

$ checker-277/scan-build \
        -enable-checker nullability.NullPassedToNonnull \
        -enable-checker nullability.NullReturnedFromNonnull \
        -enable-checker nullability.NullableDereferenced \
        -enable-checker nullability.NullablePassedToNonnull \
        xcodebuild

本文所有譯文僅供學習與交流之用,轉載請注明譯者、出處與本文鏈接。感謝博文視點為本期翻譯活動提供贊助。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved