Objective-C 的 NSPredicate 與NSSortDescriptor 能用,但一旦查詢邏輯稍複雜,程式碼就會迅速變成巢狀的 block 地獄。Linq to Objective-C 借鏡 .NET 的 LINQ,為 NSArray 與 NSDictionary 加上一串串流式的查詢方法,讓資料處理回到可讀的樣子。
把 NSArray+LinqExtensions.h/.m 與 NSDictionary+LinqExtensions.h/.m 四個檔案加入專案並引入標頭即可(也可透過 CocoaPods 安裝)。
假設有一組 Person 物件,每個都有 name 屬性,要取出不重複的姓名並排序後串成逗號分隔字串:
LINQSelector surnameSelector = ^id(id person) {
return [person name];
};
LINQAccumulator csvAccumulator = ^id(id item, id aggregate) {
return [NSString stringWithFormat:@"%@, %@", aggregate, item];
};
NSArray *surnamesList = [[[[people linq_select:surnameSelector]
linq_sort]
linq_distinct]
linq_aggregate:csvAccumulator];
方法鏈(fluent interface)就是這個庫的核心價值:每一步只做一件事,串起來就是完整的查詢意圖。
NSArray:linq_where、linq_select、linq_sort、linq_ofType、linq_selectMany、linq_distinct、linq_aggregate、linq_firstOrNil、linq_lastOrNil、linq_skip、linq_take、linq_any、linq_all、linq_groupBy、linq_toDictionary、linq_count、linq_concat、linq_reverse
NSDictionary:linq_where、linq_select、linq_toArray、linq_any、linq_all、linq_count、linq_merge
以下範例多使用這個 Person 類別:
@interface Person : NSObject @property (retain, nonatomic) NSString *name; @property (retain, nonatomic) NSNumber *age; @end
NSArray *peopleWhoAre25 = [input linq_where:^BOOL(id person) {
return [[person age] isEqualToNumber:@25];
}];
把每個元素轉換成另一種形式,輸出陣列:
NSArray *names = [input linq_select:^id(id person) {
return [person name];
}];
- (NSArray *)linq_sort; - (NSArray *)linq_sort:(LINQSelector)keySelector; - (NSArray *)linq_sortDescending; - (NSArray *)linq_sortDescending:(LINQSelector)keySelector;
自然排序:
NSArray *input = @[@21, @34, @25]; NSArray *sorted = [input linq_sort]; // 21, 25, 34 NSArray *desc = [input linq_sortDescending]; // 34, 25, 21
以 key 排序:
NSArray *sortedByName = [input linq_sort:^id(id person) {
return [person name];
}];
NSArray *mixed = @[@"foo", @25, @"bar", @33]; NSArray *strings = [mixed linq_ofType:[NSString class]];
與 select 類似,但 selector 必須回傳陣列,結果會被攤平成單一序列:
NSArray *data = @[@"foo,bar", @"fubar"];
NSArray *components = [data linq_selectMany:^id(id string) {
return [string componentsSeparatedByString:@","];
}];
// => foo, bar, fubar
NSArray *names = @[@"bill", @"bob", @"bob", @"brian", @"bob"];
NSArray *distinct = [names linq_distinct]; // bill, bob, brian
// 以 key 決定相等性
NSArray *uniqueAges = [input linq_distinct:^id(id person) {
return [person age];
}];
把整個陣列折疊成單一值:
NSArray *names = @[@"bill", @"bob", @"brian"];
id csv = [names linq_aggregate:^id(id item, id aggregate) {
return [NSString stringWithFormat:@"%@, %@", aggregate, item];
}];
// => bill, bob, brian
NSArray *numbers = @[@22, @45, @33];
id biggest = [numbers linq_aggregate:^id(id item, id aggregate) {
return [item compare:aggregate] == NSOrderedDescending ? item : aggregate;
}];
// => 45
取第一/最後一個元素,空陣列時回傳 nil 而不崩潰——這是它比 [array firstObject] 更貼心的地方(也支援傳入條件)。
NSArray *rest = [input linq_skip:2]; // 跳過前 2 個 NSArray *head = [input linq_take:2]; // 只取前 2 個
BOOL isAnyEqual = [input linq_any:^BOOL(id item) {
return [item isEqualToNumber:@25];
}];
BOOL areAllEqual = [input linq_all:^BOOL(id item) {
return [item isEqualToNumber:@25];
}];
NSUInteger n = [input linq_count:^BOOL(id item) {
return [item isEqualToNumber:@25];
}];
NSArray *input = @[@"James", @"Jim", @"Bob"];
NSDictionary *grouped = [input linq_groupBy:^id(id name) {
return [name substringToIndex:1];
}];
// => { J = (James, Jim); B = (Bob); }
NSArray *input = @[@"Frank", @"Jim", @"Bob"];
NSDictionary *dic = [input linq_toDictionaryWithKeySelector:^id(id item) {
return [item substringToIndex:1];
} valueSelector:^id(id item) {
return [item lowercaseString];
}];
// => { F = frank; J = jim; B = bob; }
// 省略 valueSelector 時,value 即原元素
NSDictionary *dic2 = [input linq_toDictionaryWithKeySelector:^id(id item) {
return [item substringToIndex:1];
}];
// => { F = Frank; J = Jim; B = Bob; }
NSArray *joined = [a linq_concat:b]; // 串接 NSArray *reversed = [input linq_reverse]; // 反轉
linq_where —— 依 key/value 過濾:
NSDictionary *result = [input linq_where:^BOOL(id key, id value) {
return [key isEqual:value];
}];
linq_select —— 投影 value:
NSDictionary *result = [input linq_select:^id(id key, id value) {
return [value substringToIndex:1];
}];
linq_toArray —— 攤平成陣列:
NSDictionary *input = @{@"A": @"Apple", @"B": @"Banana", @"C": @"Carrot"};
NSArray *result = [input linq_toArray:^id(id key, id value) {
return [NSString stringWithFormat:@"%@, %@", key, value];
}];
linq_any / linq_all / linq_count:
NSDictionary *input = @{@"a": @"apple", @"b": @"banana", @"c": @"bat"};
BOOL anyHasN = [input linq_any:^BOOL(id key, id value) {
return [value rangeOfString:@"n"].length != 0;
}]; // YES
BOOL allHaveA = [input linq_all:^BOOL(id key, id value) {
return [value rangeOfString:@"a"].length != 0;
}]; // YES
NSUInteger count = [input linq_count:^BOOL(id key, id value) {
return [value rangeOfString:key].length != 0;
}]; // 2(bat 不含 c)
linq_merge —— 合併,key 衝突時以傳入的字典為準:
NSDictionary *input = @{@"a": @"apple", @"b": @"banana", @"c": @"cat"};
NSDictionary *result = [input linq_merge:@{@"d": @"dog", @"e": @"elephant"}];
Linq to Objective-C 的價值在**可讀性**:資料轉換的意圖寫成一行鏈式呼叫,比嵌套 block 容易讀也更容易改。它採 MIT 授權,可自由用於商業專案。
但也別忘了成本:多數方法會產生中間陣列,鏈太長時記憶體與效能都不划算;而每個 block 呼叫都有 runtime 開銷。實務建議是——**鏈控制在 3~5 步以內**,用在資料整理與視圖模型組裝這類可讀性優先的場景;若在即時性高的迴圈或大量資料上,仍以原生 API 為主。而在 Swift 中,map/filter/reduce 已是語言原生功能,不需要額外引入任何庫。