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

iOS 讀取並解析 CSV 文件:從沙盒到數組的完整實現

編輯:iOS 開發綜合

做過數據相關功能的人大概都遇過這種情況:後台或運維給了一份 CSV 格式的導出數據,需要 App 把它讀進來展示,或者導入本地數據庫。相比 Excel,CSV 體積小、解析依賴少,是很實用的交換格式。

一、什麼是 CSV

CSV 是 Comma-Separated Values(逗號分隔值)的縮寫,有時也稱字符分隔值——分隔符不一定是逗號,也可以是分號、製表符等。它以純文本形式存儲表格數據,不同記錄各占一行,同一行中的字段用分隔符隔開。因為格式簡單、通用性強,它常被用作不同程序之間交換數據的中間格式。

在 Xcode 中,CSV 文件屬於體積很小的文本資源,寫入時需要遵守以下約定:

(1)開頭不留空行,以行為單位。
(2)每條記錄占一行,以逗號作為分隔符;列為空也要保留其位置。
(3)可含或不含列名,若含列名則位於文件第一行。
(4)一行數據不跨行,且無空行。
(5)字段中包含逗號時,該字段必須用雙引號括起來。
(6)字段中包含換行符時,該字段必須用雙引號括起來。
(7)字段前後包含空格時,該字段必須用雙引號括起來(a b c ==> "a b c")。
(8)字段中的雙引號用兩個雙引號表示(我說:"abc"。 ==> 我說:""abc""。)
(9)字段中若含雙引號,該字段必須用雙引號括起來
    (我說:"abc"。 ==> "我說:"""abc"""。)

理解這些規則很重要:如果數據里存在帶逗號的內容(比如地址、金額格式),沒有正確加引號,解析時字段就會錯位。

二、讀取與解析實現

iOS 中沒有現成的 CSV 解析器,但用 C 標準庫逐行讀取,再按分隔符切分,已經足夠應對大多數場景:

+ (NSArray *)readCSVData {
    NSMutableArray *_InfoArray = [[NSMutableArray alloc] init];

    NSString *filepath = [[NSBundle mainBundle] pathForResource:@"員工表" ofType:@"csv"];
    FILE *fp = fopen([filepath UTF8String], "r");
    if (fp == NULL) {
        NSLog(@"CSV 文件打開失敗");
        return nil;
    }

    char buf[BUFSIZ];
    // 跳過首行列名
    fgets(buf, BUFSIZ, fp);

    while (!feof(fp)) {
        memset(buf, 0, sizeof(buf));
        if (fgets(buf, BUFSIZ, fp) == NULL) {
            break;
        }

        // C 字符串轉 NSString
        NSString *s = [[NSString alloc] initWithUTF8String:(const char *)buf];
        // 去掉行尾的回車與換行
        NSString *ss = [s stringByReplacingOccurrencesOfString:@"\r" withString:@""];
        ss = [ss stringByReplacingOccurrencesOfString:@"\n" withString:@""];
        if (ss.length == 0) {
            continue;
        }

        // 按逗號切分成一行字段
        NSArray *a = [ss componentsSeparatedByString:@","];
        [_InfoArray addObject:a];
    }

    fclose(fp);
    NSLog(@"%@", _InfoArray);
    return _InfoArray;
}

幾個實現細節值得注意:

記得 fclose。原樣的示例代碼漏了這一步,長時間運行會造成文件描述符泄漏。

緩存區要清零。fgets 讀到文件末尾時,緩存區中可能殘留上一行的內容,用 memset 或判斷返回值可以避免解析出重複數據。

編碼問題。如果 CSV 是 GBK 編碼(國內 Excel 導出很常見),initWithUTF8String: 會返回 nil,此時需要改用:

NSString *s = [[NSString alloc] initWithData:[NSData dataWithBytes:buf length:strlen(buf)]
                                   encoding:NSCFStringEncoding];

三、更嚴謹的方案

上面這段代碼在字段簡單時可用,但一旦遇到「字段內含逗號並用雙引號包裹」的情況就會出錯。如果數據格式不可控,建議按狀態機思路解析:遍歷字符,遇到雙引號切換「是否在引號內」狀態,只有不在引號內的逗號才作為分隔符。或者直接引入成熟的第三方庫(如 CHCSVParser),它們對轉義、多行字段、自定義分隔符都有完整支持。

另外,如果解析後的數據需要頻繁查詢,與其每次讀文件建數組,不如一次性導入 SQLite 或 Core Data,後續按條件檢索會高效得多。

小結

CSV 解析本身不難,難的是把格式約定和邊界情況處理清楚:跳過列名、清理換行符、處理編碼、正確關閉文件、防範帶引號的字段。把這幾點照顧到,一個幾十行的解析方法就能穩定服務於大多數業務場景。

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