IOS開發之NSDictionary裡setValue:forKey與setObject:forKey、objectForKey與valueForKey的差異

setValue:forKey與setObject:forKey的差異

在使用NSMutableDictionary的時候經常會使用setValue forKey與setObject forKey，他們經常是可以互動使用的，代碼中經常每一種的使用都有。

1,先看看setValue： forKey：的定義

@interface NSMutableDictionary(NSKeyValueCoding)

/* Send -setObject:forKey: to the receiver, unless the value is nil, in which case send -removeObject:forKey:.

*/

- (void)setValue:(id)value forKey:(NSString *)key;

@end

擴充NSMutableDictionary的一個類別，上面注釋說的很清楚，發送setObject:forKey
給接收者，也就是調用setObject:forKey方法

除非value為nil的時候，調用方法removeObject:forKey

2,看看setObject：forKey：的定義

@interface NSMutableDictionary :NSDictionary

- (void)removeObjectForKey:(id)aKey;

- (void)setObject:(id)anObject forKey:(id <NSCopying>)aKey;

@end

注意：setObject：forKey：中Key的對象是一個id類型，並不是NSString，只不過我們經常使用NSString而已。

現在總結他們2者的區別就是：

1, setObject：forkey：中value是不能夠為nil的，不然會報錯。

setValue：forKey：中value能夠為nil，但是當value為nil的時候，會自動調用removeObject：forKey方法

2, setValue：forKey：中key的參數只能夠是NSString類型，而setObject：forKey：的可以是任何類型

注意：setObject：forKey：對象不能存放nil要與下面的這種情況區分：

1, [imageDictionarysetObject:[NSNullnull] forKey:indexNumber];

[NSNull null]表示的是一個Null 物件，並不是nil，注意這點

2, setObject：forKey：中Key是NSNumber對象的時候，如下：

    [imageDictionarysetObject:obj forKey:[NSNumber numberWithInt：10]];

注意：

上面說的區別是針對調用者是dictionary而言的。

setObject:forKey:方法NSMutabledictionary特有的,而

setValue:forKey:方法是KVC（鍵-值編碼）的主要方法。

當 setValue:forKey:方法調用者是對象的時候：

setValue:forKey:方法是在NSObject對象中建立的，也就是說所有的oc對象都有這個方法，所以可以用於任何類。

比如使用:

SomeClass *someObj = [[SomeClass alloc] init];

[someObj setValue:self forKey:@"delegate"];

表示的意思是：對象someObj設定他的delegate屬性的值為當前類，當然調用此方法的對象必須要有delegate屬性才能設定，不然調用了也沒效果

objectForKey與valueForKey的差異

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