前言
在项目开发中遇见本地化搜索不是很高，当有本地化搜索的需求时候对 NSPredicate 的语法都去网上搜索，然而苹果官方也没有专门介绍语法，借这次机会总结和写下谓词的语法，方便以后开发查看
NSPredicate 的语法
-
比较运算符
- =，==：判断两个表达式是否相等，在谓词中=和==是相同的意思都是判断，而没有赋值这一说
- =，=>：判断左边表达式的值是否大于或等于右边表达式的值
>：判断左边表达式的值是否大于右边表达式的值- <：判断左边表达式的值是否小于右边表达式的值
- !=、<>：判断两个表达式是否不相等
- BETWEEN：BETWEEN 表达式必须满足表达式 BETWEEN {下限，上限}的格式，要求该表达式必须大于或等于下限，并小于或等于上限
例：
//数据源
let word = ["a","b","c","d","e","f","g","h","i","j","k","l","m","n","o"]
//相等判断
let equalPredicate:NSPredicate = NSPredicate.init(format: "SELF == 'b'")
print("word[1] is = b -> \(equalPredicate.evaluate(with: word[1]))")
//之间判断
let betweenPredicate:NSPredicate = NSPredicate.init(format: "SELF BETWEEN {'d','m'}")
for item in word {
print("word item is between {'d','m'} -> \(betweenPredicate.evaluate(with: item))")
}
word[1] is = b -> true
word item is between {'d','m'} -> false
word item is between {'d','m'} -> false
word item is between {'d','m'} -> false
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> true
word item is between {'d','m'} -> false
word item is between {'d','m'} -> false
-
逻辑运算符
- BEGINSWITH：检查某个字符串是否以指定的字符串开头（如判断字符串 是否以 a 开头：BEGINSWITH ‘a’）
- ENDSWITH：检查某个字符串是否以指定的字符串结尾
- CONTAINS：检查某个字符串是否包含指定的字符串
- LIKE：检查某个字符串是否匹配指定的字符串模板。其之后可以跟?代表一个字符和代表任意多个字符两个通配符。比如”name LIKE ‘ac’“，这表示 name 的值中包含 ac 则返回 YES；”name LIKE ‘?ac’“，表示 name 的第 1、1. 个字符为 ac 时返回 YES。
- MATCHES：检查某个字符串是否匹配指定的正则表达式。虽然正则表达式的执行效率是最低的，但其功能是最强大的，也是我们最常用的。
注：字符串比较都是区分大小写和重音符号的。如：café 和 cafe 是不一样的，Cafe 和 cafe 也是不一样的。如果希望字符串比较运算不区分大小写和重音符号，请在这些运算符后使用[c]，[d]选项。其中[c]是不区分大小写，[d]是不区分重音符号，其写在字符串比较运算符之后，比如：name LIKE[cd] ‘cafe’，那么不论 name 是 cafe、Cafe 还是 café 上面的表达式都会返回 YES。
例：最常见的就是正则匹配了
//判断是不是邮箱
let emailRegular = "[A-Z0-9a-z._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}"
let emailpredicate = NSPredicate(format:"SELF MATCHES %@", emailRegular)
print("www.llllll.com is = email -> \(emailpredicate.evaluate(with: "www.llllll.com"))")
print("www@llllll.com is = email -> \(emailpredicate.evaluate(with: "www@llllll.com"))")
www.llllll.com is = email -> false
www@llllll.com is = email -> true
-
集合运算符
- ANY、SOME：集合中任意一个元素满足条件，就返回 YES。
- ALL：集合中所有元素都满足条件，才返回 YES。
- NONE：集合中没有任何元素满足条件就返回 YES。如:NONE person.age < 18，表示 person 集合中所有元素的 age>=18 时，才返回 YES。
- IN：等价于 SQL 语句中的 IN 运算符，只有当左边表达式或值出现在右边的集合中才会返回 YES。
例：
//数据源
let word = ["a","b","c","d","e","f","g","h","i","j","k","l","m","n","o"]
//集合判断
let equalPredicate:NSPredicate = NSPredicate.init(format: "NONE SELF > 'p'")
print("word 所有元素都不是大于p -> \(equalPredicate.evaluate(with: word))")
word 所有元素都不是大于p -> true
-
直接量值
- FALSE、NO：代表逻辑假
- TRUE、YES：代表逻辑真
- NULL、NIL：代表空值
- SELF：代表正在被判断的对象自身
- “string”或’string’：代表字符串
- 数组：和 c 中的写法相同，如：{‘one’, ‘two’, ‘three’}。
- 数值：包括证书、小数和科学计数法表示的形式
- 十六进制数：0x 开头的数字
- 八进制：0o 开头的数字
- 二进制：0b 开头的数字
在谓词表达式中可以使用如上直接量
- 保留值
下列单词都是保留字（不论大小写）：AND、OR、IN、NOT、ALL、ANY、SOME、NONE、LIKE、CASEINSENSITIVE、CI、MATCHES、CONTAINS、BEGINSWITH、ENDSWITH、BETWEEN、NULL、NIL、SELF、TRUE、YES、FALSE、NO、FIRST、LAST、SIZE、ANYKEY、SUBQUERY、CAST、TRUEPREDICATE、FALSEPREDICATE
注：虽然大小写都可以，但是更推荐使用大写来表示这些保留字，也是上面介绍到的语法，没介绍到的自己理解吧，或者给我留言
- 在谓词中使用占位符参数
%K：用于动态传入属性名
%@：用于动态设置属性值
- 例：最后来一个综合的本地搜索吧，对自定义对象进行筛选
//自定义对象
@interface YContactObject : NSObject
/**
* 联系人的姓名对象
*/
@property (nonatomic, strong)YContactNameObject * nameObject;
@end
//姓名对象
@interface YContactNameObject : NSObject
/**
* 姓名
*/
@property (nonatomic, copy)NSString * name;
/**
* 昵称
*/
@property (nonatomic, copy) NSString * nickName;
/**
* 名字
*/
@property (nonatomic, copy) NSString * givenName;
-(NSString *)getName
{
//除nil处理
self.middleName = (self.middleName) ? self.middleName : @"";
self.givenName = (self.givenName) ? self.givenName : @"";
self.familyName = (self.familyName) ? self.familyName : @"";
self.name = [[self.familyName stringByAppendingString:self.middleName] stringByAppendingString:self.givenName];
return self.name;
}
@end
//通讯录数组
self.sourceContactObjects:[YContactObject] = [**********]
self.contactObjects:[YContactObject] = []
//姓名过滤谓词
let predicateString:String = String.init(format: "(SELF.nameObject.getName CONTAINS '%@') OR ((SELF.phoneObject != NIL) AND (SELF.getFirstPhone CONTAINS '%@'))", searchText,searchText)
let filterPredicate:NSPredicate = NSPredicate.init(format: predicateString)
self.contactObjects = (sourceContactObjects as NSArray).filtered(using: filterPredicate) as! [YContactObject]
运行结果
后续有什么问题或者建议，请给我留言