NSDictionary细说（六）—— 字典的遍历

版本记录

版本号	时间
V1.0	2017.08.28

前言

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

一、- (NSEnumerator *)keyEnumerator

该方法的作用就是：返回一个枚举器对象，允许您访问字典中的每个键。

下面代码说明了如何使用此方法。

NSEnumerator *enumerator = [myDictionary keyEnumerator];
id key;
 
while ((key = [enumerator nextObject])) {
    /* code that uses the returned key */
}

下面还要注意：

• 如果您使用此方法与NSDictionary的可变子类的实例，则您的代码在枚举期间不应修改条目。 如果您打算修改条目，请使用allKeys属性来创建字典键的“快照”。 然后使用此快照遍历条目，沿途修改它们。
• 请注意，objectEnumerator方法提供了访问字典中每个值的便捷方式。
• 特别注意事项：使用快速枚举协议（参见NSFastEnumeration）更为有效。 macOS 10.5及更高版本以及iOS 2.0及更高版本中提供快速枚举。

结论：字典键的枚举器。

---

二、- (NSEnumerator *)objectEnumerator;

该方法的作用是：返回一个枚举器对象，允许您访问字典中的每个值。

具体示例可以参考下面代码

NSEnumerator *enumerator = [myDictionary objectEnumerator];
id value;
 
while ((value = [enumerator nextObject])) {
    /* code that acts on the dictionary’s values */
}

这里还要注意：

• 如果您使用此方法与NSDictionary的可变子类的实例，则您的代码在枚举期间不应修改条目。 如果您打算修改条目，请使用allValues方法来创建字典值的“快照”。 从此快照工作以修改值。
• 使用快速枚举协议（参见NSFastEnumeration）更为有效。 macOS 10.5及更高版本以及iOS 2.0及更高版本中提供快速枚举。

结论：字典值的枚举器。

---

三、- (void)enumerateKeysAndObjectsUsingBlock:(void (^)(KeyType key, ObjectType obj, BOOL *stop))block;

该方法的作用就是：将给定的块对象应用于字典的条目。

这里需要注意：

• 同数组的遍历相似，当stop被设置为YES，那么遍历就结束了。

下面我们看示例代码。

- (void)demoEnumerateKeysAndObjectsUsingBlock
{
    NSDictionary *dict = @{@"One" : @"number1", @"Two" : @"number2", @"Three" : @"number3"};
    [dict enumerateKeysAndObjectsUsingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
        NSLog(@"key = %@", key);
        NSLog(@"obj = %@", obj);
    }];
}

下面看输出结果

2017-08-28 14:09:08.441551+0800 JJOC[800:489957] key = One
2017-08-28 14:09:08.441622+0800 JJOC[800:489957] obj = number1
2017-08-28 14:09:08.441641+0800 JJOC[800:489957] key = Two
2017-08-28 14:09:08.441657+0800 JJOC[800:489957] obj = number2
2017-08-28 14:09:08.441676+0800 JJOC[800:489957] key = Three
2017-08-28 14:09:08.441692+0800 JJOC[800:489957] obj = number3

结论：字典的遍历一般都用这个方法，大家要熟记和理解它。

---

四、- (void)enumerateKeysAndObjectsWithOptions:(NSEnumerationOptions)opts usingBlock:(void (^)(KeyType key, ObjectType obj, BOOL *stop))block;

该方法的作用就是：将给定的块对象应用于字典的条目。

下面我们看一下参数：

• opts：枚举选项，是一个枚举。

typedef NS_OPTIONS(NSUInteger, NSEnumerationOptions) {
    NSEnumerationConcurrent = (1UL << 0),
    NSEnumerationReverse = (1UL << 1),
};

• block：对整个字典的每一项应用的block代码块。

下面我们看示例代码

- (void)demoEnumerateKeysAndObjectsWithOptions
{
    NSDictionary *dict = @{@"One" : @"number1", @"Two" : @"number2", @"Three" : @"number3"};
    [dict enumerateKeysAndObjectsWithOptions:NSEnumerationReverse usingBlock:^(id  _Nonnull key, id  _Nonnull obj, BOOL * _Nonnull stop) {
        NSLog(@"key = %@", key);
        NSLog(@"obj = %@", obj);
    }];
}

下面看输出结果

2017-08-28 14:14:01.712315+0800 JJOC[805:490818] key = One
2017-08-28 14:14:01.712370+0800 JJOC[805:490818] obj = number1
2017-08-28 14:14:01.712382+0800 JJOC[805:490818] key = Two
2017-08-28 14:14:01.712393+0800 JJOC[805:490818] obj = number2
2017-08-28 14:14:01.712404+0800 JJOC[805:490818] key = Three
2017-08-28 14:14:01.712416+0800 JJOC[805:490818] obj = number3

结论：带有枚举选项值的字典遍历，可以看做是方法三的进一步条件优化。

后记

未完，待续~~~~