NSPredicate 是 Foundation 提供的查詢過濾工具,讓你能用類似 SQL 的語法描述條件,然後套用到陣列或 Core Data 請求上。相比一堆 if-else,它讓篩選邏輯寫得更像自然語言。
支援 >、<、==、>=、<=、!=
@"number >= 99"
AND、OR、NOT,分別計算且、或、非的結果。
IN 與 BETWEEN
@"number BETWEEN {1, 5}"
@"address IN {'shanghai', 'nanjing'}"
代表元素本身,用於對陣列中的純值進行比對:
@"SELF == 'APPLE'"
BEGINSWITH、ENDSWITH、CONTAINS
@"name CONTAINS[cd] 'ang'" // 包含某字串
@"name BEGINSWITH[c] 'sh'" // 以某字串開頭
@"name ENDSWITH[d] 'ang'" // 以某字串結尾
修飾符說明:[c] 不區分大小寫(case-insensitive);[d] 不區分發音符號(diacritic-insensitive),即忽略重音標記;[cd] 兩者同時生效。
@"name LIKE[cd] '*er*'"
@"name LIKE[cd] '???er*'"
* 代表零或多個字元,? 代表恰好一個字元。LIKE 同樣接受 [cd] 修飾符。
NSString *regex = @"^A.+e$"; // 以 A 開頭、e 結尾
@"name MATCHES %@", regex
NSArray *array = @[@"aa", @"bb"];
NSArray *array2 = @[@"aa", @"bb", @"cc", @"dd"];
NSPredicate *predicate =
[NSPredicate predicateWithFormat:@"NOT(SELF in %@)", array];
NSArray *result = [array2 filteredArrayUsingPredicate:predicate];
NSLog(@"%@", result); // 輸出 {@"cc", @"dd"}
NSString *regex = @"^A.+e$";
NSPredicate *predicate =
[NSPredicate predicateWithFormat:@"SELF MATCHES %@", regex];
if ([predicate evaluateWithObject:@"Apple"]) {
NSLog(@"YES");
} else {
NSLog(@"NO");
}
這樣寫語法上沒問題:
NSPredicate *p = [NSPredicate predicateWithFormat:@"name = %@", @"name1"];
但更清晰的做法是使用範本加替代變數:
NSPredicate *template =
[NSPredicate predicateWithFormat:@"name == $NAME"];
NSDictionary *variables = @{ @"NAME" : @"name1" };
NSPredicate *predicate =
[template predicateWithSubstitutionVariables:variables];
這種寫法在需要反覆用不同值查詢同一個條件時特別有用,因為範本只需編譯一次。
當過濾條件的欄位名稱本身也是動態的時,很多人會直覺寫成:
NSString *key = @"name";
NSString *value = @"name1";
NSPredicate *p = [NSPredicate predicateWithFormat:@"%@ = %@", key, value];
執行到這裡就會報錯,而邏輯上看不出任何問題。
原因是:%@ 會把參數當作「值」處理,並自動加上引號,最終生成的謂詞字串實際上是 'name' = 'name1'——系統在拿兩個字串字面量做比較,而不是在存取 name 欄位。
正確做法是把欄位名的佔位符改成 %K:
NSPredicate *p = [NSPredicate predicateWithFormat:@"%K = %@", key, value];
牢記這個區別:%K 用於欄位/key path,%@ 用於值。這兩個佔位符用混是 NSPredicate 最常見的錯誤來源,而且錯誤訊息通常完全不指向真正的原因。