您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

Foundation 框架基礎函式總覽:各類 API 的用途速查

編輯:iOS 相關資訊

用 Objective-C 開發時,除了琳瑯滿目的類別,Foundation 框架其實還提供了大量全域函式與類函式巨集。這些工具平時不起眼,遇到特定問題時卻往往是最省事的那把螺絲刀。以下依功能分類整理,並說明各組的實際用途。

斷言(Assertions)

NSAssert 系列(NSAssert、NSAssert1 到 NSAssert5)用於物件方法內部,NSCAssert 系列則用於 C 函式內部——因為 C 函式沒有 self,無法取得當前物件。NSCParameterAssert 與 NSParameterAssert 專門用來檢查參數是否合法。斷言在 Release 組態下會被編譯器移除,因此適合放「不該發生」的前提檢查,而不該拿來做真正的錯誤處理。

在地化字串(Bundles)

NSLocalizedString 是最常用的一個,預設從 main bundle 的 Localizable.strings 取值。若字串放在自訂的 strings 表,用 NSLocalizedStringFromTable;若該表不在 main bundle,用 NSLocalizedStringFromTableInBundle;需要同時提供預設值時用 NSLocalizedStringWithDefaultValue。

位元組序轉換(Byte Ordering)

這一整組 NSSwap 開頭的函式負責處理大端與小端序轉換。跨平台讀寫二進位檔、實作網路協定封包時一定會遇到。命名規則很規律:NSSwapHostIntToBig 表示把主機序轉成大端,NSSwapLittleIntToHost 則是把小端轉回主機序,Int、Long、Short、Float、Double 各有對應版本。日常開發多半用不到,但底層或跨語言資料交換時是必需品。

十進位運算(Decimals)

NSDecimalAdd、NSDecimalSubtract、NSDecimalMultiply、NSDecimalDivide 等函式提供精確的十進位運算。涉及金額計算時,絕對不要使用 float 或 double——二進位浮點數無法精準表示 0.1 這類小數,累積誤差遲早出問題。如果覺得 C 風格函式不好用,也可以改用 NSDecimalNumber 類別。

例外處理(Exception Handling)

NS_DURING、NS_HANDLER、NS_ENDHANDLER、NS_VALUERETURN、NS_VOIDRETURN 這組巨集實作在 NSException.h 中,但已標記為廢棄,新專案不應使用。請改用 @try / @catch / @finally,或 NSError 的錯誤回傳模式。

與 Objective-C Runtime 互動

NSClassFromString 與 NSStringFromClass 讓你能用字串動態取得類別,這是實作可設定外掛、對應表驅動架構的基礎。NSSelectorFromString 與 NSStringFromSelector 處理 SEL 與名稱的轉換,常用於動態呼叫與日誌輸出。NSStringFromProtocol 與 NSProtocolFromString 則對應 Protocol。NSGetSizeAndAlignment 可以取得型別的大小與對齊資訊。

日誌輸出(Logging)

NSLog 是最基本的輸出函式,NSLogv 則接受 va_list,適合包裝自己的日誌函式時使用。

檔案路徑管理

NSHomeDirectory 取得 App 的沙盒根目錄,NSHomeDirectoryForUser 取得指定使用者的家目錄,NSTemporaryDirectory 取得暫存區。NSSearchPathForDirectoriesInDomains 是最實用的一個,傳入 NSCachesDirectory、NSDocumentDirectory 等參數即可取得符合規範的路徑——請永遠用它來取路徑,不要把路徑字串寫死在程式碼裡。NSFullUserName 與 NSUserName 取得使用者名稱,NSOpenStepRootDirectory 則是 legacy 用途。

NSRange 操作

NSMakeRange 建立範圍,NSMaxRange 取得範圍末端位置,NSLocationInRange 判斷某位置是否落在範圍內,NSEqualRanges 比較兩個範圍是否相同。NSIntersectionRange 取交集、NSUnionRange 取聯集,在文字處理與版面計算中非常實用。NSRangeFromString 與 NSStringFromRange 則負責與字串互轉,方便除錯時印出。

未攔截例外處理器

NSSetUncaughtExceptionHandler 可以註冊一個全域函式,攔截未被 catch 的例外。若沒有設定這個處理器,未攔截的例外會直接讓程式終止(發送通知期間拋出的例外是唯一的例外情況)。這是收集線上崩潰資訊的常用手法,NSGetUncaughtExceptionHandler 則用來讀回目前設定。

Core Foundation 與 ARC 橋接

CFBridgingRetain 與 CFBridgingRelease 用於在 ARC 物件與 CF 物件之間轉換所有權。當你把 __bridge 轉好的 CF 物件存進泛型容器,或需要明確轉移所有權時就會用到,用錯很容易造成重複釋放或記憶體洩漏。

記憶體與頁面管理

NSAllocateMemoryPages、NSDeallocateMemoryPages、NSCopyMemoryPages 直接操作記憶體分頁,NSLogPageSize 與 NSPageSize 取得頁面大小,NSRoundDownToMultipleOfPageSize 與 NSRoundUpToMultipleOfPageSize 做頁面對齊,NSRealMemoryAvailable 回報可用實體記憶體。這組 API 屬於底層工具,一般應用開發很少直接使用。

Zones(已不建議使用)

NSCreateZone、NSRecycleZone、NSZoneMalloc、NSZoneFree 等一整套 zone 相關函式,在 iOS 與 OS X 的 64 位元 runtime 上已被忽略。Apple 明確表示現階段開發不應使用 zones,看到舊程式碼裡出現這些呼叫,可以視為需要清理的技術債。

物件配置與引用計數

NSAllocateObject、NSCopyObject、NSDeallocateObject 用於手動配置與複製物件;NSIncrementExtraRefCount、NSDecrementExtraRefCountWasZero、NSExtraRefCount、NSShouldRetainWithZone、NSMakeCollectable 則是與手動計數、垃圾回收相關的 legacy API。在 ARC 專案中這些都不該出現。

總結來說,這份清單裡真正高頻使用的是:NSLocalizedString 系列、NSSearchPathForDirectoriesInDomains、NSMakeRange 家族、NSClassFromString、以及 NSAssert。其餘多數屬於特定領域的專用工具,知道它們存在,遇到問題時能少走很多彎路。

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