談到 Foundation,多數人腦中浮現的是 NSString、NSArray 這些類別。但這個框架其實還藏著一整套自由函式與類函式巨集,處理著斷言、位元組序、十進位運算、記憶體分頁、路徑與範圍計算等瑣事。它們通常宣告在 Foundation/Foundation.h 中,分散於 NSBundle.h、NSByteOrder.h、NSDecimal.h、NSException.h、NSObjCRuntime.h、NSObject.h、NSPathUtilities.h、NSRange.h、NSZone.h 等標頭檔裡。
NSAssert 到 NSAssert5 對應不同參數數量,NSCAssert 系列則是給 C 函式使用的版本(因為巨集表達式裡拿不到 self)。此外還有 NSParameterAssert 與 NSCParameterAssert,專門用來檢查函式參數是否合法。想深入了解可參考《Assertions and Logging Programming Guide》。
多語言 App 的起點:NSLocalizedString、NSLocalizedStringFromTable、NSLocalizedStringFromTableInBundle、NSLocalizedStringWithDefaultValue。它們的本質是從 strings 檔中依 key 取出翻譯,寫法簡短卻撐起了整個國際化體系。
不同 CPU 架構的位元組排列方式不同,網路傳輸時更是老大難問題。Foundation 提供三類工具:
NSHostByteOrder、NSConvertHostDoubleToSwapped、NSConvertHostFloatToSwapped、NSConvertSwappedDoubleToHost、NSConvertSwappedFloatToHostNSSwapBig... 系列(Big/Little 轉 Host)與 NSSwapHost...ToBig / ...ToLittle 系列NSSwapInt、NSSwapLong、NSSwapLongLong、NSSwapShort、NSSwapFloat、NSSwapDouble浮點數的精度問題在金融場景中無可容忍,於是有了 NSDecimal 這組函式:NSDecimalAdd、NSDecimalSubtract、NSDecimalMultiply、NSDecimalDivide、NSDecimalCompare、NSDecimalRound、NSDecimalNormalize、NSDecimalCompact、NSDecimalCopy、NSDecimalPower、NSDecimalMultiplyByPowerOf10、NSDecimalString、NSDecimalIsNotANumber。若偏好物件導向風格,也可以直接用 NSDecimalNumber 類別。
NS_DURING、NS_HANDLER、NS_ENDHANDLER、NS_VALUERETURN、NS_VOIDRETURN 這幾個巨集如今已被標記為淘汰,不該再使用。現代寫法請參考《Exception Programming Topics》,或直接改用 @try / @catch。
NSAllocateObject、NSCopyObject、NSDeallocateObject 以及 NSIncrementExtraRefCount、NSDecrementExtraRefCountWasZero、NSExtraRefCount、NSShouldRetainWithZone,都是手動參考計數時代的低階工具,在 ARC 環境下基本不會直接觸碰。
這組函式是自省能力的瑞士刀:NSClassFromString 與 NSStringFromClass 在類別與名稱之間雙向轉換,NSSelectorFromString 與 NSStringFromSelector 處理方法選擇器,NSProtocolFromString 與 NSStringFromProtocol 則對應協議。NSGetSizeAndAlignment 可取得型別的大小與對齊資訊。
NSLog 是每個 iOS 工程師寫下的第一行除錯程式碼;NSLogv 則接受 va_list,方便包裝自訂的日誌函式。
NSHomeDirectory、NSHomeDirectoryForUser、NSTemporaryDirectory、NSFullUserName、NSUserName、NSOpenStepRootDirectory,以及最實用的 NSSearchPathForDirectoriesInDomains——想取得 Documents、Library、Caches 等目錄,幾乎都得靠它。
NSRange 在字串處理中無所不在,配套函式包括 NSMakeRange、NSLocationInRange、NSMaxRange、NSEqualRanges、NSUnionRange、NSIntersectionRange、NSStringFromRange、NSRangeFromString。有了它們,範圍的合併、交集與包含判斷都能一行搞定。
NSGetUncaughtExceptionHandler 與 NSSetUncaughtExceptionHandler 讓你能攔下尚未處理的例外。要注意:除非例外是在發送通知的過程中發生,否則未捕獲的例外將導致程式直接終止。
CFBridgingRetain 與 CFBridgingRelease 負責在 CF 物件與 ARC 管理的 OC 物件之間轉手所有權,是混用 Core Foundation 與 Foundation 時的關鍵。
NSAllocateMemoryPages、NSCopyMemoryPages、NSDeallocateMemoryPages、NSPageSize、NSLogPageSize、NSRealMemoryAvailable、NSRoundDownToMultipleOfPageSize、NSRoundUpToMultipleOfPageSize、NSMakeCollectable 這組 API 讓你能以「頁」為單位操作記憶體,屬於少見但偶爾必要的低階手段。
NSCreateZone、NSRecycleZone、NSZoneMalloc、NSZoneCalloc、NSZoneRealloc、NSZoneFree、NSZoneName、NSSetZoneName、NSZoneFromPointer、NSDefaultMallocZone 這一族函式,在 iOS 與 OS X 的 64 位元 runtime 上已被忽略。官方建議很明確:新開發不要再用 zone。
這些函式單看平凡,卻是 Foundation 的黏著劑。知道它們存在,往往能在需要時省下自己造輪子的時間。
資料來源:Apple Inc. Foundation Functions Reference(更新日期 2014-04-09)