先前介紹過自訂 NSDictionary 的 key,若對那篇還不太上手,不妨從最基礎的 API 開始。以下把不可變與可變字典的常用操作整理成一份可查的清單。
NSNumber *numObj = [NSNumber numberWithInt:100];
// 單一元素
NSDictionary *dic1 = [NSDictionary dictionaryWithObject:numObj forKey:@"key"];
// 多個元素(注意 nil 是結束標記)
NSDictionary *dic2 = [NSDictionary dictionaryWithObjectsAndKeys:
numObj, @"valueKey",
numObj2, @"value2",
nil];
// 由另一個字典複製而來
NSDictionary *dic3 = [NSDictionary dictionaryWithDictionary:otherDic];
// 直接從檔案內容建立(plist 格式)
NSDictionary *dic4 = [NSDictionary dictionaryWithContentsOfFile:path];
NSInteger count = [dic count]; // 元素數量
NSObject *valueObj = [dic objectForKey:@"key"]; // 以 key 取值
NSEnumerator *enumerator = [dic keyEnumerator]; // 取得 key 的列舉器
NSArray *keys = [dic allKeys]; // 所有 key
NSArray *values = [dic allValues]; // 所有 value
NSMutableDictionary *dic2 = [NSMutableDictionary dictionaryWithObjectsAndKeys:
@"v1", @"key1", @"v2", @"key2", nil];
NSDictionary *dic3 = [NSDictionary dictionaryWithObject:@"v3" forKey:@"key3"];
[dic2 addEntriesFromDictionary:dic3]; // 併入整份字典
[dic2 setValue:@"value3" forKey:@"key3"]; // 新增或覆寫單一鍵值
NSMutableDictionary *dic1 = [NSMutableDictionary dictionary];
[dic1 setDictionary:dic2]; // 讓 dic1 內容與 dic2 相同
[dic1 removeObjectForKey:@"key1"]; // 刪除單一鍵
NSArray *array = [NSArray arrayWithObjects:@"key1", nil];
[dic2 removeObjectsForKeys:array]; // 依陣列批次刪除
[dic1 removeAllObjects]; // 清空
for (id key in dic) {
id obj = [dic objectForKey:key];
NSLog(@"%@", obj);
}
NSArray *keys = [dic allKeys];
NSUInteger length = [keys count];
for (NSUInteger i = 0; i < length; i++) {
id key = [keys objectAtIndex:i];
id obj = [dic objectForKey:key];
NSLog(@"%@", obj);
}
NSEnumerator *enumerator = [dic keyEnumerator];
id key = [enumerator nextObject];
while (key) {
id obj = [dic objectForKey:key];
NSLog(@"%@", obj);
key = [enumerator nextObject];
}
字典的 key 必須唯一且不可變。存入時若 key 重複,後者會直接覆蓋前者而不報錯,這是資料遺失的常見來源。
遍歷順序不保證。NSDictionary 內部以雜湊表實作,allKeys 的順序與插入順序無關。若你需要有序輸出,請搭配 NSOrderedSet 或自行維護一個 key 陣列。
取出 nil 要小心。以不存在的 key 呼叫 objectForKey: 會得到 nil,若後續直接塞進陣列或做算術運算,就會踩到 undefined behavior。建議統一改用 -objectForKeyedSubscript: 並搭配空值判斷。
最後,dictionaryWithContentsOfFile: 只能讀取 plist 格式的檔案,且回傳的是不可變副本。若你需要寫回檔案,請改用 writeToFile:atomically:,並在寫入前確認內容都是 plist 支援的型別(NSString、NSNumber、NSData、NSDate、NSArray、NSDictionary)。