iOS NSPredicate(谓词)语法

前言

在项目开发中遇见本地化搜索不是很高,当有本地化搜索的需求时候对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、
Simulator Screen Shot 2017年9月11日 下午5.17.43.png

2、
Simulator Screen Shot 2017年9月11日 下午5.17.50.png

后续有什么问题或者建议,请给我留言

推荐阅读更多精彩内容

  • 首先,我们需要知道何谓谓词,让我们看看官方的解释: The NSPredicate class is used t...
    sunny_zl阅读 24,976评论 34 155
  • NSPredicate TheNSPredicateclass is used to define logical...
    Noman_X阅读 219评论 0 3
  • 转载自: http://www.cocoachina.com/ios/20160111/14926.html 首先...
    赵yx阅读 53评论 0 0
  • 过完21岁生日,就是22岁了。得无可得,失无所失的21岁翻篇了。 当辣辣发消息问我要不要一起过生日的时候,我刚跟室...
    澄六一阅读 42评论 0 1
  • 初读《生死场》,被萧红这句话震惊到。原来穷人里的易于暴怒,是因着苦难的原因。 柴栏外是墨沉沉的静甜的,微风不敢惊动...
    大若木木阅读 339评论 0 2