Objective-C 有著 C 語言的血統,int、float、BOOL 這些純量型別無所不在;但 Cocoa 的容器(NSArray、NSDictionary)只接受物件。於是 NSNumber 應運而生——它是純量與物件之間的橋。
NSValue → NSObjectNSCopying、NSSecureCodingNSValue.h 與 NSDecimalNumber.hNSNumber 為幾乎每一種 C 純量型別準備了對應的便利建構子,可分成有號與無號兩大系列:
+numberWithBool:、+numberWithChar:、+numberWithInt:、+numberWithInteger:、+numberWithLong:、+numberWithLongLong:、+numberWithShort:+numberWithFloat:、+numberWithDouble:+numberWithUnsignedChar:、+numberWithUnsignedInt:、+numberWithUnsignedInteger:、+numberWithUnsignedLong:、+numberWithUnsignedLongLong:、+numberWithUnsignedShort:實務上最常用的是 +numberWithInt: 與 +numberWithInteger:;後者會依平台位元寬度自動對應,在 64 位元裝置上更安全。當然,語法糖 @(value) 讓這一切變得更簡潔。
除了便利建構子,也可以走 traditional 的 -init... 路徑,例如 -initWithInt:、-initWithDouble:、-initWithBool: 等,涵蓋範圍與建構子一一對應。這兩組方法在功能上並無差異,選用哪一種多半取決於團隊風格。
包裝容易,取出才是重點。NSNumber 提供了完整的取值方法:
-boolValue、-charValue、-shortValue、-intValue、-integerValue、-longValue、-longLongValue-unsignedCharValue、-unsignedShortValue、-unsignedIntValue、-unsignedIntegerValue、-unsignedLongValue、-unsignedLongLongValue-floatValue、-doubleValue、-decimalValue值得注意的是,這些轉換是「能轉就轉」:把 3.7 取成整數會得到 3,把 YES 取成 boolValue 也只是 0 與 1 的映射,因此取值時务必確認型別與語意相符。
-stringValue 給出樸素的字串形式,-descriptionWithLocale: 則能依地區設定套用小數點與千分位等慣例,適合直接呈現給使用者。
-compare: 回傳 NSComparisonResult,-isEqualToNumber: 則做嚴格的數值相等判斷。至於 -objCType,它會告訴你這個物件背後包裝的原始 C 型別字串,在需要與 C API 對接時相當有用。
看似簡單的 NSNumber,其實是 Foundation 型別系統的螺絲釘。理解它的包裝與取值規則,能幫你避開不少資料型別轉換帶來的隱形 bug。
資料來源:Apple Inc. 官方類別參考(更新日期 2013-12-16)