IOS開發之——objectForKey與valueForKey在NSDictionary中的差異

從 NSDictionary 取值的時候有兩個方法，objectForKey: 和 valueForKey:，這兩個方法具體有什麼不同呢？

先從 NSDictionary 文檔中來看這兩個方法的定義：

objectForKey: returns the value associated with aKey, or nil if no value is associated with aKey. 返回指定 key 的 value，若沒有這個 key 返回 nil.

valueForKey: returns the value associated with a given key. 同样是返回指定 key 的 value。
 

直觀上看這兩個方法好像沒有什麼區別，但文檔裏 valueForKey: 有額外一點：

If key does not start with “@”, invokes objectForKey:. If key does start with “@”, strips the “@” and invokes [super valueForKey:] with the rest of the key. via Discussion

一般來說 key 可以是任意字符串組合，如果 key 不是以 @ 符號開頭，這時候 valueForKey: 等同於 objectForKey:，如果是以 @ 開頭，去掉 key 裏的 @ 然後用剩下部分作为 key 執行 [super valueForKey:]。
 

比如：

NSDictionary *dict = [NSDictionary dictionaryWithObject:@"theValue"

                                                 forKey:@"theKey"];

NSString *value1 = [dict objectForKey:@"theKey"];

NSString *value2 = [dict valueForKey:@"theKey"];
 

這時候 value1 和 value2 是一样的結果。如果是這样一個 dict：

NSDictionary *dict = [NSDictionary dictionaryWithObject:@"theValue"

                                                 forKey:@"@theKey"];// 注意這個 key 是以 @ 開頭

NSString *value1 = [dict objectForKey:@"@theKey"];

NSString *value2 = [dict valueForKey:@"@theKey"];
 

value1 可以正確取值，但是 value2 取值會直接 crash 掉，報錯信息：

Terminating app due to uncaught exception ‘NSUnknownKeyException’, reason: ‘[<__NSCFDictionary 0x892fd80> valueForUndefinedKey:]: this class is not key value coding-compliant for the key theKey.’

這是因为 valueForKey: 是 KVC(NSKeyValueCoding) 的方法，在 KVC 裏可以通過 property 同名字符串來獲取對應的值。比如：

@interface Person : NSObject

@property (nonatomic, retain) NSString *name;

@end

...

Person *person = [[Person alloc] init];

person.name = @"fannheyward";

NSLog(@"name:%@", [person name]);

//name:fannheyward

NSLog(@"name:%@", [person valueForKey:@"name"]);

//name:fannheyward

[person release];
 

valueForKey: 取值是找和指定 key 同名的 property accessor，沒有的時候執行 valueForUndefinedKey:，而 valueForUndefinedKey: 的默認實現是拋出 NSUndefinedKeyException 異常。

回過頭來看剛才 crash 的例子， [dict valueForKey:@"@theKey"]; 會把 key 裏的 @ 去掉，也就變成了 [dict valueForKey:@"theKey"];，而 dict 不存在 theKey 這样的 property，轉而執行 [dict valueForUndefinedKey:@"theKey"];，拋出 NSUndefinedKeyException 異常後 crash 掉。

objectForKey: 和 valueForKey: 在多數情況下都是一样的結果返回，但是如果 key 是以 @ 開頭，valueForKey: 就成了一個大坑，建議在 NSDictionary 下只用 objectForKey: 來取值。