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

iOS 檔案操作總整理:路徑取得、存在判斷與多編碼讀取

編輯:iOS 開發綜合

檔案相關的操作是每個專案都會用到的基礎能力。以下整理幾個最常見的需求與對應寫法,並持續補充。

1. 取得 App bundle 內檔案的絕對路徑

NSString *absoluteFileName =
    [[[NSBundle mainBundle] bundlePath] stringByAppendingPathComponent:@"filename.ext"];

bundle 是唯讀的,適合存放隨 App 一起打包的靜態資源。任何寫入需求都必須換到 App 沙盒內的目錄。

2. 取得 Documents 目錄下檔案的絕對路徑

// 取得文件根目錄(此目錄可在 iTunes 檔案共享中看見並增減)
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                                                     NSUserDomainMask,
                                                     YES);
// 通常只有一個,取第一個即可
NSString *documentsDirectory = [paths objectAtIndex:0];

// 拼接檔名,得到完整路徑
NSString *absoluteFileName =
    [documentsDirectory stringByAppendingPathComponent:@"filename.ext"];

iOS 沙盒中幾個常用目錄的用途值得記住:

  • Documents:使用者產生的資料,會被 iCloud/iTunes 備份,且預設對使用者可見。
  • Library/Caches:可重新產生的快取(網路圖片、暫存檔案),不會被備份,系統在空間不足時可能清掉。
  • tmp:暫存檔,隨時可能被系統清除,App 未執行時尤其不可靠。
  • Library/Preferences:NSUserDefaults 的存放處,不建議手動操作。

3. 判斷指定路徑的檔案是否存在

NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                                                     NSUserDomainMask,
                                                     YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *absoluteFileName =
    [documentsDirectory stringByAppendingPathComponent:fileName];

NSFileManager *fileManager = [NSFileManager defaultManager];

if (![fileManager fileExistsAtPath:absoluteFileName]) {
    // 文件目錄中沒有,改從 App bundle 中尋找
    absoluteFileName = [[[NSBundle mainBundle] bundlePath]
        stringByAppendingPathComponent:fileName];
}

這個「先找沙盒、再退回 bundle」的模式非常實用:App 首次啟動時從 bundle 把預設檔案複製到 Documents,之後一律讀 Documents 的版本,使用者修改的內容就能被保留下來。

4. 以多種編碼載入檔案內容

// UTF-8
NSString *fileContent = [NSString stringWithContentsOfFile:absoluteFileName
                                                  encoding:NSUTF8StringEncoding
                                                     error:nil];
// GB 18030(簡體中文常見編碼)
NSStringEncoding stringEncoding =
    CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000);

NSString *fileContent = [NSString stringWithContentsOfFile:absoluteFileName
                                                  encoding:stringEncoding
                                                     error:nil];

更多編碼標識可查閱 CoreFoundation/CFStringEncodingExt.h 中的宣告。實務上遇到不明編碼的文字檔,比較有效率的做法是逐一嘗試常見編碼(UTF-8、UTF-16、GB 18030、Big5、Shift JIS),並用下列啟發式方法自動判斷:

// 讓系統自行偵測編碼
NSString *content = [NSString stringWithContentsOfFile:absoluteFileName
                                  usedEncoding:&detectedEncoding
                                         error:&error];
NSLog(@"偵測到的編碼:%lu", (unsigned long)detectedEncoding);

補充:幾個實用上更安全的寫法

  • 拼接路徑時,用 stringByAppendingPathComponent: 而非字串格式化加上 /,前者會處理重複與缺失的斜線。
  • 讀寫檔案務必傳入 NSError ** 並檢查,不要傳 nil 就當它一定成功。檔案系統錯誤(權限、空間、路徑不存在)在真實環境中很常見。
  • 寫入時加上 atomically:YES(或 NSData writeToFile:options:NSDataWritingAtomic)。原子寫入會先寫暫存檔再改名,能避免寫到一半被中斷而留下半個壞檔。
  • 列舉目錄內容用 contentsOfDirectoryAtPath:error: 或 enumeratorAtPath:,不要用已废弃的 directoryContentsAtPath:。
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved