前言
在项目开发中遇见本地化搜索不是很高，当有本地化搜索的需求时候对NSPredicate的语法都去网上搜索，然而苹果官方也没有专门介绍语法，借这次机会总结和写下谓词的语法，方便以后开发查看
NSPredicate的语法
比较运算符
1、=，==：判断两个表达式是否相等，在谓词中=和==是相同的意思都是判断，而没有赋值这一说
2、>=，=>：判断左边表达式的值是否大于或等于右边表达式的值
3、>：判断左边表达式的值是否大于右边表达式的值
4、<：判断左边表达式的值是否小于右边表达式的值
5、!=、<>：判断两个表达式是否不相等
6、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
逻辑运算符
1、BEGINSWITH：检查某个字符串是否以指定的字符串开头（如判断字符串 是否以a开头：BEGINSWITH 'a'）
2、ENDSWITH：检查某个字符串是否以指定的字符串结尾
3、CONTAINS：检查某个字符串是否包含指定的字符串
4、LIKE：检查某个字符串是否匹配指定的字符串模板。其之后可以跟?代表一个字符和代表任意多个字符两个通配符。比如"name LIKE 'ac'"，这表示name的值中包含ac则返回YES；"name LIKE '?ac'"，表示name的第2、3个字符为ac时返回YES。
5、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
集合运算符
1、ANY、SOME：集合中任意一个元素满足条件，就返回YES。
2、ALL：集合中所有元素都满足条件，才返回YES。
3、NONE：集合中没有任何元素满足条件就返回YES。如:NONE person.age < 18，表示person集合中所有元素的age>=18时，才返回YES。
4、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
直接量值
在谓词表达式中可以使用如下直接量
1、FALSE、NO：代表逻辑假
2、TRUE、YES：代表逻辑真
3、NULL、NIL：代表空值
4、SELF：代表正在被判断的对象自身
5、"string"或'string'：代表字符串
6、数组：和c中的写法相同，如：{'one', 'two', 'three'}。
7、数值：包括证书、小数和科学计数法表示的形式
8、十六进制数：0x开头的数字
9、八进制：0o开头的数字
10、二进制：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]
运行结果
1、
2、
后续有什么问题或者建议，请给我留言
