iOS 實現類似通訊錄按拼音排序 - PinYin4Objc

項目中需要實現類似通訊錄那樣按拼音進行排序以及索引列表的顯示的功能，我這里使用了 PinYin4Objc 這個庫來實現此功能。

PinYinObjc是一個效率很高的漢字轉拼音類庫，智齒簡體和繁體中文，有如下特點：

1.效率高，使用數據緩存，第一次初始化以后，拼音數據存入文件緩存和內存緩存，后面轉換效率大大提高； 2.支持自定義格式化，拼音大小寫等等； 3.拼音數據完整，支持中文簡體和繁體，與網絡上流行的相關項目比，數據很全，幾乎沒有出現轉換錯誤的問題.

下載 PinYinObjc

項目中的實際應用

項目需求：

顯示一個班級的成員列表，有一個是管理員要排在最上面，下面按照拼音排序實現索引列表，效果圖如下：

 

代碼實現過程

查詢數據庫獲取成員列表

//成員列表根據 isAdmin 字段進行排序查詢——order by isAdmin
NSMutableArray *members = [[ASMemberDao sharedInstance] queryAllMembersByGroupId:groupId];
//根據排序查詢結果第一個為管理員
ASContact *memeberAdmin = [members objectAtIndex:0];

將每個成員的名字轉化成拼音

//初始化HanyuPinyinOutputFormat對象，設置相應的 type
HanyuPinyinOutputFormat *outputFormat=[[HanyuPinyinOutputFormat alloc] init];
[outputFormat setToneType:ToneTypeWithoutTone];
[outputFormat setVCharType:VCharTypeWithV];
[outputFormat setCaseType:CaseTypeUppercase];
//遍歷成員列表，將成員名字 contactName 轉成拼音，並存放到 categoryName 字段中，用於排序
[members enumerateObjectsUsingBlock:^(id obj, NSUInteger idx, BOOL *stop) {
    ASContact *contact = (ASContact *)obj;
    NSString *outputPinyin=[PinyinHelper toHanyuPinyinStringWithNSString:contact.contactName withHanyuPinyinOutputFormat:outputFormat withNSString:@""];
    contact.categoryName = [outputPinyin uppercaseString];
}];
[outputFormat release];

將成員列表按照拼音字段 categoryName進行排序

NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"categoryName" ascending:YES];
NSArray *array = [[NSArray alloc] initWithObjects:sortDescriptor, nil];
[members sortUsingDescriptors:array];
[array release];
[sortDescriptor release];

定義一個全局變量 dataDictionary 來組織數據結構

key: 將漢字轉完拼音后的第一個字母, 也就是上圖 section 中的 A、B、C...

value: 是一個成員數組，存放每個 section 下的成員列表

如上圖： A 是字典的一個 Key, 對應的 value 就是成員數組 {af1, af10},當然數組中存放的是成員對象。

dataDictionary = [[NSMutableDictionary alloc] init];
//存放每個 section 下的成員數組
NSMutableArray *currentArray = nil;
//用於獲取拼音中第一個字母
NSRange aRange = NSMakeRange(0, 1);
NSString *firstLetter = nil;
//遍歷成員列表組織數據結構
for (ASContact *contact in members) {
    //如果是管理員，則暫時不放如 dataDictionary 中
    if (contact.isAdmin == 1) {
         continue;
    }
    //獲取拼音中第一個字母，如果已經存在則直接將該成員加入到當前的成員數組中，如果不存在，創建成員數據，添加一個 key-value 結構到 dataDictionary 中
    firstLetter = [contact.categoryName substringWithRange:aRange];
    if ([dataDictionary objectForKey:firstLetter] == nil) {
        currentArray = [NSMutableArray array];
        [dataDictionary setObject:currentArray forKey:firstLetter];
    }
    [currentArray addObject:contact];
}

在定義一個全局變量 allKeys 用於顯示索引列表中索引

//取出 dataDictionary 中的 key 並進行排序
allKeys = [[NSMutableArray alloc] initWithArray:[[dataDictionary allKeys] sortedArrayUsingFunction:sortObjectsByKey context:NULL]];
//然后將管理員加入到排好序 allKeys 的最前面
[allKeys insertObject:@"管理員" atIndex:0];
[dataDictionary setObject:[NSArray arrayWithObjects:contactAdmin, nil] forKey:@"管理員"];

最后就是通過 allKeys 和 dataDictionary 進行配置一下 tableview 的各個代理就 OK 了，這里不在贅述

希望對閱讀本文的你有幫助