來源

https://developer.apple.com/library/content/documentation/Cocoa/Conceptual/KeyValueCoding/CollectionOperators.html#//apple_ref/doc/uid/20002176-BAJEAIEE

當你要發送valueForKeyPath:消息給KVC對象時,你可以把集合運算包含在key path里.集合運算符是前面帶有(@)的關鍵字.它可以在數據返回前執行特定的操作.NSObject提供的valueForKeyPath:默認實現實現了這種行為.
當key path包含集合運算符時,在運算符前面的是left key path,它表示接收運算符的集合.如果你直接把消息發送給集合對象(比如:NSArray對象),left key path可能會被忽略.
運算符后面的,就是right key path,它表示運算符是在哪個集合屬性上發生作用.所有的集合運算符(除了@count外),都需要一個right key path.

key path 運算格式

集合運算的三種基本運算類型:

• 匯總運算:以某種方式合并集合對象,并返回一個單一的對象,這個對象的類型是和right key path里的屬性一樣的.@count運算符是特例,你沒有right key path并總是返回NSNumber實例.
• 數組運算:總是返回集合里的子集
• 嵌套運算:作用在包含了其它集合的集合,并返回一個NSArray或NSSet實例.以某種方式合并了嵌套集合.

例子

@interface BankAccount : NSObject
 
@property (nonatomic) NSNumber* currentBalance;              // An attribute
@property (nonatomic) Person* owner;                         // A to-one relation
@property (nonatomic) NSArray< Transaction* >* transactions; // A to-many relation
 
@end

@interface Transaction : NSObject
 
@property (nonatomic) NSString* payee;   // To whom
@property (nonatomic) NSNumber* amount;  // How much
@property (nonatomic) NSDate* date;      // When
 
@end

為了討論,假設BankAccount實例,有以下數據在transactions數組里:

你可以簡單的通過把 self 作為操作符后面的 key path 來獲取一個由 NSNumber 組成的數組或者集合的總值，例如對于數組 @[@(1), @(2), @(3)] 可使用 valueForKeyPath:@"@max.self" 來獲取最大值。

@avg:

valueForKeyPath:讀取集合里每個元素的right key path屬性,把它轉成double(nil值用0表示),并計算它們的算術平均值.最后把結果存在NSNumber實例里并返回.

NSNumber *transactionAverage = [self.transactions valueForKeyPath:@"@avg.amount"];
///transactionAverage 的結果是$456.54

@count

valueForKeyPath:返回集合里有多少個對象,并存在NSNumber實例里.如果出現right key path將被忽略.

NSNumber *numberOfTransactions = [self.transactions valueForKeyPath:@"@count"];
//numberOfTransactions的值為13

@max

valueForKeyPath:將搜索集合里全部的right key path的實體,并返回最大的那個.這個搜索是用compare:方法來對比的.所以right key path所指向的實體必須是可以使用這個方法的.搜索會忽略nil.

NSDate *latestDate = [self.transactions valueForKeyPath:@"@max.date"];
//latestDate的值是 Jul 15, 2016

@min

與@max相反

NSDate *earliestDate = [self.transactions valueForKeyPath:@"@min.date"];
// earliestDate的值是 Dec 1, 2015

@sum

valueForKeyPath:讀取集合里每個元素的right key path屬性,把它轉成double(nil值用0表示),并計算它們的合.最后把結果存在NSNumber實例里并返回.

NSNumber *amountSum = [self.transactions valueForKeyPath:@"@sum.amount"];
// amountSum的值是$5935.00

Array Operators

valueForKeyPath:返回一個right key path所指向屬性的數組,這個屬性是集合元素相關聯的.

如果所有返回的屬性都是nil,valueForKeyPath:方法會拋出異常

@distinctUnionOfObjects

會返回right key path所指向對象的數組,是重復的將被忽略

NSArray *distinctPayees = [self.transactions valueForKeyPath:@"@distinctUnionOfObjects.payee"];
//distinctPayees的結果:Car Loan, General Cable, Animal Hospital, Green Power, Mortgage.

@unionOfObjects

和@distinctUnionOfObjects相似的行為,但這個并不移除重復的對象.

NSArray *payees = [self.transactions valueForKeyPath:@"@unionOfObjects.payee"];
// payees的結果:Green Power, Green Power, Green Power, Car Loan, Car Loan, Car Loan, General Cable, General Cable, General Cable, Mortgage, Mortgage, Mortgage, Animal Hospital.注意有重復的.

Nesting Operators

NSArray* moreTransactions = @[<# transaction data #>];
NSArray* arrayOfArrays = @[self.transactions, moreTransactions];

moreTransactions里的數據

@distinctUnionOfArrays

NSArray *collectedDistinctPayees = [arrayOfArrays valueForKeyPath:@"@distinctUnionOfArrays.payee"];
// collectedDistinctPayees的結果:Hobby Shop, Mortgage, Animal Hospital, Second Mortgage, Car Loan, General Cable - Cottage, General Cable, Green Power

@unionOfArrays

和@distinctUnionOfArrays一樣,但包含重復的數據

NSArray *collectedPayees = [arrayOfArrays valueForKeyPath:@"@unionOfArrays.payee"];

collectedPayees的結果:Green Power, Green Power, Green Power, Car Loan, Car Loan, Car Loan, General Cable, General Cable, General Cable, Mortgage, Mortgage, Mortgage, Animal Hospital, General Cable - Cottage, General Cable - Cottage, General Cable - Cottage, Second Mortgage, Second Mortgage, Second Mortgage, Hobby Shop.

@distinctUnionOfSets

這個和@distinctUnionOfArrays是一樣的,只不過它用在NSSet實例包含NSSet實例,而不是NSArray包含NSArray.并且,它也是返回一個NSSet實例.