KVC集合运算符

KVC集合运算符允许在valueForKeyPath:
方法中使用key path符号在一个集合中执行方法。无论什么时候你在key path中看见了@
,它都代表了一个特定的集合方法,其结果可以被返回或者链接,就像其他的key path一样。
集合运算符会根据其返回值的不同分为以下三种类型:

**简单的集合运算符** 返回的是strings, number, 或者 dates
**对象运算符** 返回的是一个数组
**数组和集合运算符** 返回的是一个数组或者集合

示例数据
以下示例会用到一些数据,先看看示例数据。
一个 Product 类和由 Product 类对象所组成的 products 数组

@interface Product : NSObject
@property NSString *name;
@property CGFloat price;
@property NSDate *launchedOn;
@end

products 数组中 Product 类对象所使用数据如下:

Name      Price Launch Date
iPhone5   $199  September 21, 2012
iPhone5   $199  September 21, 2012
iPhone5   $199  September 21, 2012
iPad Mini    $329   November 2, 2012
MacBook Pro  $1699  June 11,2012
MacBook Pro  $1699  June 11,2012
iMac         $1299  November 2, 2012

还有另一个数组 products2,它内部元素也是 Product 类对象,数据如下:
Name        Price       Launch Date
iPhone5  $199     September 21, 2012
iPad Mini   $329      November 2, 2012
MacBook Pro  $1699     June 11,2012
iMac        $1299   November 2, 2012
iMac        $1299   November 2, 2012
iMac        $1299   November 2, 2012

简单集合操作符
作用于 array 或者 set 中相对于集合操作符右侧的属性。包括

@avg, @count, @max, @min, @sum.

@avg 操作符将集合中属性键路径所指对象转换为 double, 计算其平均值,返回该平均值的 NSNumber 对象。当均值为 nil 的时候,返回 0.
@count 操作符返回集合中对象总数的 NSNumber 对象。操作符右边没有键路径。
@max 操作符比较由操作符右边的键路径指定的属性值,并返回比较结果的最大值。最大值由指定的键路径所指对象的 compare: 方法决定,因此参加比较的对象必须支持和另一个对象的比较。如果右侧键路径所指对象值为 nil, 则忽略,不影响比较结果。
@min 和 @max 一样,但是返回的是集合中的最小值。
@sum 返回右侧键路径指定的属性值的总和。每一个比较值都转换为 double,然后计算值的总和,最后返回总和值的 NSNumber 对象。如果右侧键路径所指对象值为 nil,则忽略。

[products valueForKeyPath:@"@count"]; // 7
[products valueForKeyPath:@"@sum.price"]; // 5632.00
[products valueForKeyPath:@"@avg.price"]; // 804.5714285714286
[products valueForKeyPath:@"@max.price"]; // 1699.00
[products valueForKeyPath:@"@min.launchedOn"]; // June 11, 2012

对象操作符
对象操作符包括 @distinctUnionOfObjects 和 @unionOfObjects, 返回一个由操作符右边的 key path 所指定的对象属性组成的数组。其中 @distinctUnionOfObjects 会对数组去重,而 @unionOfObjects 不会。

NSArray *unionOfObjects = [products valueForKeyPath:@"@unionOfObjects.name"]; // 1. 
NSArray *distinctUnionObjects = [products valueForKeyPath:@"@distinctUnionOfObjects.name"];  //2.

unionOfObjects 中会包含 “iPhone5”, “iPhone5”,“iPhone5”, “iPad Mini”, “MacBook Pro”, “MacBook Pro”, “iMac”
distinctUnionObjects 中会包含 “iPhone5”, “iPad Mini”, “MacBook Pro”, “iMac”, 相当于对 unionOfObjects 数组进行去重处理。

数组和集合操作符
数组和集合操作符作用对象是嵌套的集合,也就是说,是一个集合且其内部每个元素是一个集合。数组和集合操作符包括

@distinctUnionOfArrays
@unionOfArrays
@distinctUnionOfSets

@distinctUnionOfArrays / @unionOfArrays 返回一个数组,其中包含这个集合中每个数组对于这个操作符右面指定的 key path 进行操作之后的值。 distinct 版本会移除重复的值。
@distinctUnionOfSets 和 @distinctUnionOfArrays 差不多, 但是它期望的是一个包含着 NSSet 对象的 NSSet ,并且会返回一个 NSSet 对象。因为集合不能包含重复的值,所以它只有 distinct 操作。

假定有个 totalProducts 数组,其包含两个数组 productsproducts2,以下代码片段展示了 totalProducts 的创建。

totalProducts = [NSMutableArray array];
[totalProducts addObject:products];
[totalProducts addObject:products2];

其中 productsproducts2 中元素都是 Product 类对象,其内部数据使用的是[示例数据]的数据内容。
对于以下操作:

NSArray *distinctUnionOfArrays = [totalProducts valueForKeyPath:@"@distinctUnionOfArrays.name"];
NSArray *unionOfArrays = [totalProducts valueForKeyPath:@"@unionOfArrays.name"];

那么 unionOfArrays 中包含 “iPhone5”, “iPhone5”, “iPhone5”, “iPad Mini”, “MacBook Pro”, “MacBook Pro”, “iMac”, “iPhone5”, “iPad Mini”, “MacBook Pro”, “iMac”, “iMac”, “iMac” 共 13 个元素。
distinctUnionOfArrays 中仅包含 “iPhone5”, “iPad Mini”, “MacBook Pro”, “iMac” 共 4 个元素。
~

~

~

参考:
https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/KeyValueCoding/CollectionOperators.html
http://nshipster.cn/kvc-collection-operators/
http://liumh.com/2015/09/04/ios-kvc-collection-operators/#disqus_thread


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容