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

一、@property(readonly, copy) NSArray<KeyType> *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,
    

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

    二、- (NSArray<KeyType> *)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 = (
        Three
    

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

    三、@property(readonly, copy) NSArray<ObjectType> *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<ObjectType> *)objectsForKeys:(NSArray<KeyType> *)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:细微的区别。

    未完,待续~~~~