版本记录
版本号 | 时间 |
---|---|
V1.0 | 2017.08.28 |
前言
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,
key2
)
结论:获取指定字典的键的数组。
二、- (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 = (
One,
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:
细微的区别。
后记
未完,待续~~~~