NSDictionary细说（五）—— 键和值的获取

版本记录

版本号	时间
V1.0	2017.08.28

前言

NSDictionary是不可变字典，它的不可变性可以参考NSArray数组，但是它与数组还是有很大不同，尽管他们都属于集合类，下面这几篇我们继续来将一下基础类的知识。还是老规矩从整体到局部，从浅入深进行讲解，谢谢大家。感兴趣的可以参考我上面几篇。
1. NSDictionary细说（一）—— 整体了解
2. NSDictionary细说（二）—— 字典的创建
3. NSDictionary细说（三）—— 字典的初始化
4. NSDictionary细说（四）—— 共享键集、数量以及相等比较

一、@property(readonly, copy) NSArray *allKeys;

该属性的作用就是：获取给定字典的所有键值，是一个数组。如果是一个空字典，那么会返回一个空数组。

这里还要注意：

• 数组中元素的顺序未定义

下面看示例代码

- (void)demoAllKeys
{
    NSDictionary *dict = [[NSDictionary alloc] initWithObjectsAndKeys:@"value1", @"key1", @"value2", @"key2", nil];
    NSArray *arr = dict.allKeys;
    NSLog(@"arr = %@", arr);
}

看输出结果

2017-08-28 11:38:21.660809+0800 JJOC[735:467685] arr = (
    key1,
    key2
)

结论：获取指定字典的键的数组。

---

二、- (NSArray *)allKeysForObject:(ObjectType)anObject

该方法的作用就是：返回一个包含与字典中给定对象的所有出现对应的键的新数组。

这里还要注意：

• 一个包含与字典中所有出现的对象相对应的键的新数组。 如果没有找到与Object匹配的对象，则返回一个空数组
• 字典中的每个对象都发送一个isEqual：消息，以确定它是否等于anObject。

下面看示例代码

- (void)demoAllKeysForObject
{
    NSDictionary *dict = @{@"One" : @"number1", @"Three" : @"number1", @"Two" : @"2"};
    NSArray *arr = [dict allKeysForObject:@"number1"];
    NSLog(@"arr = %@", arr);
}

下面看输出结果

2017-08-28 11:44:07.781203+0800 JJOC[738:468546] arr = (
    One,
    Three
)

结论：获取相同对象的所有的key组成的数组。

---

三、@property(readonly, copy) NSArray *allValues;

该属性的作用就是：包含字典值的新数组，如果字典没有条目，则为空数组。

这里还要注意：

• 数组中的值的顺序未定义。

下面看实例代码

- (void)demoAllValues
{
    NSDictionary *dict = [[NSDictionary alloc] initWithObjectsAndKeys:@"value1", @"key1", @"value2", @"key2", nil];
    NSArray *arr = dict.allValues;
    NSLog(@"arr = %@", arr);
}

下面看输出结果

2017-08-28 11:48:32.517574+0800 JJOC[741:469217] arr = (
    value1,
    value2
)

结论：获取字典中所有值对应的数组。

---

四、- (void)getObjects:(ObjectType _Nonnull [])objects andKeys:(KeyType _Nonnull [])keys;

该方法的作用就是：返回字典中键和值的引用C数组。

下面看一下参数：

• objects：返回时，包含字典中值的C数组
• keys：返回时，包含字典中的键的C数组

这里还要注意：

• 返回数组和键数组中的元素具有一一对应关系，因此返回数组中的第n个对象与键数组中的键相对应。

结论：获取给定字典的键C数组和值C数组。

---

五、- (ObjectType)objectForKey:(KeyType)aKey;

该方法的作用就是：获取给定键对应的值。

这里还要注意：如果aKey对应的值不存在，那么会返回nil。

下面看示例代码

- (void)demoObjectForKey
{
    NSDictionary *dict = @{@"One" : @"number1", @"Three" : @"number1", @"Two" : @"2"};
    id obj = [dict objectForKey:@"One"];
    NSLog(@"obj = %@", obj);
}

看输出结果

2017-08-28 12:22:26.537086+0800 JJOC[750:474726] obj = number1

结论：获取指定key对应的值对象。

---

六、- (ObjectType)objectForKeyedSubscript:(KeyType)key;

该方法的作用就是：返回与给定键相关联的值。

下面还要注意：

• 与键相关联的值，如果没有值与aKey相关联，则为nil。
• 此方法与objectForKey：方法具有相同的行为。您不应该直接调用此方法。 而是使用下标通过键访问对象时调用此方法。

看实例代码

id value = dictionary[@"key"]; 
// equivalent to [dictionary objectForKeyedSubscript:@"key"]

结论：作用同objectForKey :，但是不能直接调用它。

---

七、- (NSArray *)objectsForKeys:(NSArray *)keys notFoundMarker:(ObjectType)marker;

该方法的作用就是：从与字典对应的指定键的对象集合作为NSArray返回。

下面看一下参数：

• keys：一个NSArray，其中包含用于返回相应值的键。
• marker：如果在字典中没有找到对应于给定键的对象，则将标记对象放置在返回的数组的相应元素中。

这里还要注意：

• 返回的数组和键数组中的对象具有一对一的对应关系，因此返回数组中第n个对象对应于键数组中第n个键。

看示例代码

- (void)demoObjectsForKeysNotFoundMaker
{
    NSDictionary *dict = @{@"One" : @"number1", @"Two" : @"number2", @"Three" : @"number3"};
    NSArray *keyArr = @[@"One", @"Four"];
    NSString *nofFoundMaker  = @"The value does not exits";
    NSArray *arr = [dict objectsForKeys:keyArr notFoundMarker:nofFoundMaker];
    NSLog(@"nofFoundMaker = %@", nofFoundMaker);
    NSLog(@"arr = %@", arr);
}

看输出结果

2017-08-28 12:40:33.470972+0800 JJOC[764:477556] nofFoundMaker = The value does not exits
2017-08-28 12:40:33.471096+0800 JJOC[764:477556] arr = (
    number1,
    "The value does not exits"
)

结论：输出键数组对应的值数组，并给出键对应的值不存在的情况。

---

八、- (ObjectType)valueForKey:(NSString *)key;

该方法的作用就是：返回与给定键相关联的值。

下面看一下参数和返回值：

• key：返回相应值的键。 请注意，当使用键值编码时，该键必须是一个字符串。
• return：与键相关的值

还要注意：

• 如果键不以“@”开头，则调用objectForKey：。 如果键以“@”开头，则删除“@”，并使用键的其余部分调用[super valueForKey：]。

结论：注意要与objectForKey：细微的区别。

后记

未完，待续~~~~