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: 來取值。