ios - 谓词文档

NSPredicate

TheNSPredicateclass is used to define logical conditions used to constrain a search either for a fetch or for in-memory filtering.

Creating a Predicate  

+predicateWithFormat:

+ (NSPredicate *)predicateWithFormat:(NSString *)predicateFormat,...;

Creates and returns a new predicate formed by creating a new string with a given format and parsing the result

创建并返回一个新的谓词 ,该谓词通过创建给定格式的新字符串并解析获得。

+predicateWithFormat:argumentArray:

+ (NSPredicate *)predicateWithFormat:(NSString *)predicateFormatargumentArray:(NSArray *)arguments;

Creates and returns a new predicate by substituting the values in a given array into a format string and parsing the result

通过将给定数组中的值替换为格式字符串并解析结果 来创建并返回一个新谓词

+predicateWithFormat:arguments:

+ (NSPredicate *)predicateWithFormat:(NSString *)predicateFormatarguments:(va_list)argList;

Creates and returns a new predicate by substituting the values in an argument list into a format string and parsing the result.

通过将参数列表中的值替换为格式字符串并解析结果来创建和返回一个新谓词。

-predicateWithSubstitutionVariables:

Returns a copy of the receiver with the receiver’s variables substituted by values specified in a given substitution variables dictionary.

返回接收者的拷贝,接收者的变量由给定替代变量字典中指定的值替代。

+predicateWithValue:

Creates and returns a predicate that always evaluates to a given value.

创建并返回一个始终求值为给定值的谓词。

+predicateWithBlock:

Creates and returns a predicate that evaluates using a specified block object and bindings dictionary.

创建并返回一个谓词,该谓词使用指定的块对象和绑定字典进行计算。

Evaluating a Predicate

-evaluateWithObject:

Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver.

返回一个布尔值,该值指示给定对象是否与接收方指定的条件相匹配。

-evaluateWithObject:substitutionVariables:

Returns a Boolean value that indicates whether a given object matches the conditions specified by the receiver after substituting in the values in a given variables dictionary.

返回一个布尔值,该值指示在给定变量字典中替换某个给定对象后是否匹配接收方指定的条件。

-allowEvaluation

Force a predicate that was securely decoded to allow evaluation.

强制安全地解码以允许评估的谓词。

Getting a String Representation

predicateFormat

The receiver’s format string.

接收器的格式字符串。

Initializers  -- 初始化

+predicateFromMetadataQueryString:

Relationships -- 关联

Inherits From  --- NSObject   继承自nsobject 类

Conforms To  ---- NSCopying,NSSecureCoding 


使用谓词过滤不可变集合和可变集合的区别是:过滤不可变集合时,会返回符合条件的集合元素组成的新集合;过滤可变集合时,没有返回值,会直接剔除不符合条件的集合元素


-----------------------以下内容为 借用别人文章----  -------------------

原文链接:http://www.cocoachina.com/ios/20160111/14926.html

NSPredicate类是用来定义逻辑条件约束的获取或内存中的过滤搜索。

可以使用谓词来表示逻辑条件,用于描述对象持久性存储在内存中的对象过滤。其实意思就是:我是一个过滤器,不符合条件的都滚开。

一、NSPredicate的基本语法

我们使用一门语言,无论是外语还是计算机语言,总是从语法开始的,这样我们才能正确的把握逻辑。所以我们从语法开始说起。在这部分我们仅关心其语法的使用

只要我们使用谓词(NSPredicate)都需要为谓词定义谓词表达式,而这个表达式必须是一个返回BOOL的值。

谓词表达式由表达式、运算符和值构成。

1.比较运算符

比较运算符如下

=、==:判断两个表达式是否相等,在谓词中=和==是相同的意思都是判断,而没有赋值这一说

1

2

3

4

5NSNumber *testNumber = @123;

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF = 123"];

if([predicate evaluateWithObject:testNumber]) {

NSLog(@"testString:%@", testNumber);

}

我们可以看到输出的内容为:

1

2016-01-07 11:12:27.281 PredicteDemo[4130:80412] testString:123

>=,=>:判断左边表达式的值是否大于或等于右边表达式的值

<=,=<:判断右边表达式的值是否小于或等于右边表达式的值

>:判断左边表达式的值是否大于右边表达式的值

<:判断左边表达式的值是否小于右边表达式的值

!=、<>:判断两个表达式是否不相等

BETWEEN:BETWEEN表达式必须满足表达式 BETWEEN {下限,上限}的格式,要求该表达式必须大于或等于下限,并小于或等于上限

1

2

3

4

5

6

7NSNumber *testNumber = @123;

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF BETWEEN {100, 200}"];

if([predicate evaluateWithObject:testNumber]) {

NSLog(@"testString:%@", testNumber);

}else{

NSLog(@"不符合条件");

}

输出结果为:

1

2016-01-07 11:20:39.921 PredicteDemo[4366:85408] testString:123

2.逻辑运算符

AND、&&:逻辑与,要求两个表达式的值都为YES时,结果才为YES。

1

2

3

4NSArray *testArray = @[@1, @2, @3, @4, @5, @6];

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"SELF > 2 && SELF < 5"];

NSArray *filterArray = [testArray filteredArrayUsingPredicate:predicate];

NSLog(@"filterArray:%@", filterArray);

输出结果为:

1

2

3

42016-01-07 11:27:01.885 PredicteDemo[4531:89537] filterArray:(

3,

4

)

OR、||:逻辑或,要求其中一个表达式为YES时,结果就是YES

NOT、 !:逻辑非,对原有的表达式取反

3.字符串比较运算符

BEGINSWITH:检查某个字符串是否以指定的字符串开头(如判断字符串是否以a开头:BEGINSWITH 'a')

ENDSWITH:检查某个字符串是否以指定的字符串结尾

CONTAINS:检查某个字符串是否包含指定的字符串

LIKE:检查某个字符串是否匹配指定的字符串模板。其之后可以跟?代表一个字符和*代表任意多个字符两个通配符。比如"name LIKE '*ac*'",这表示name的值中包含ac则返回YES;"name LIKE '?ac*'",表示name的第2、3个字符为ac时返回YES。

MATCHES:检查某个字符串是否匹配指定的正则表达式。虽然正则表达式的执行效率是最低的,但其功能是最强大的,也是我们最常用的。

注:字符串比较都是区分大小写和重音符号的。如:café和cafe是不一样的,Cafe和cafe也是不一样的。如果希望字符串比较运算不区分大小写和重音符号,请在这些运算符后使用[c],[d]选项。其中[c]是不区分大小写,[d]是不区分重音符号,其写在字符串比较运算符之后,比如:name LIKE[cd] 'cafe',那么不论name是cafe、Cafe还是café上面的表达式都会返回YES。

4.集合运算符

ANY、SOME:集合中任意一个元素满足条件,就返回YES。

ALL:集合中所有元素都满足条件,才返回YES。

NONE:集合中没有任何元素满足条件就返回YES。如:NONE person.age < 18,表示person集合中所有元素的age>=18时,才返回YES。

IN:等价于SQL语句中的IN运算符,只有当左边表达式或值出现在右边的集合中才会返回YES。我们通过一个例子来看一下

1

2

3

4NSArray *filterArray = @[@"ab", @"abc"];

NSArray *array = @[@"a", @"ab", @"abc", @"abcd"];

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"NOT (SELF IN %@)", filterArray];

NSLog(@"%@", [array filteredArrayUsingPredicate:predicate]);

代码的作用是将array中和filterArray中相同的元素去除,输出为:

1

2

3

42016-01-07 13:17:43.669 PredicteDemo[6701:136206] (

a,

abcd

)

array[index]:返回array数组中index索引处的元素

array[FIRST]:返回array数组中第一个元素

array[LAST]:返回array数组中最后一个元素

array[SIZE]:返回array数组中元素的个数

5.直接量

在谓词表达式中可以使用如下直接量

FALSE、NO:代表逻辑假

TRUE、YES:代表逻辑真

NULL、NIL:代表空值

SELF:代表正在被判断的对象自身

"string"或'string':代表字符串

数组:和c中的写法相同,如:{'one', 'two', 'three'}。

数值:包括证书、小数和科学计数法表示的形式

十六进制数:0x开头的数字

八进制:0o开头的数字

二进制:0b开头的数字

6.保留字

下列单词都是保留字(不论大小写)

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

注:虽然大小写都可以,但是更推荐使用大写来表示这些保留字

二、谓词的用法

1.定义谓词

一般我们使用下列方法来定义一个谓词

1

NSPredicate *predicate = [NSPredicate predicateWithFormat:];

下面我们通过几个简单的例子来看看它该如何使用:

首先我们需要定义一个模型,因为示例中需要用到它

ZLPersonModel.h

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16#import typedef NS_ENUM(NSInteger, ZLPersonSex) {

ZLPersonSexMale = 0,

ZLPersonSexFamale

};

@interface ZLPersonModel : NSObject

/** NSString 姓名 */

@property (nonatomic, copy) NSString *name;

/** NSUInteger 年龄 */

@property (nonatomic, assign) NSUInteger age;

/** ZLPersonSex 性别 */

@property (nonatomic, assign) ZLPersonSex sex;

+ (instancetype)personWithName:(NSString *)name age:(NSUInteger)age sex:(ZLPersonSex)sex;

@end

下面让我们进入正题

例一:(最简单的使用)

1

2

3

4

5

6

7

8

9

10

11ZLPersonModel *sunnyzl = [ZLPersonModel personWithName:@"sunnyzl"age:29 sex:ZLPersonSexMale];

ZLPersonModel *jack = [ZLPersonModel personWithName:@"jack"age:22 sex:ZLPersonSexMale];

//  首先我们来看一些简单的使用

//  1.判断姓名是否是以s开头的

NSPredicate *pred1 = [NSPredicate predicateWithFormat:@"name LIKE 's*'"];

//  输出为:sunnyzl:1, jack:0

NSLog(@"sunnyzl:%d, jack:%d", [pred1 evaluateWithObject:sunnyzl], [pred1 evaluateWithObject:jack]);

//  2.判断年龄是否大于25

NSPredicate *pred2 = [NSPredicate predicateWithFormat:@"age > 25"];

//  输出为:sunnyzl的年龄是否大于25:1, jack的年龄是否大于25:0

NSLog(@"sunnyzl的年龄是否大于25:%d, jack的年龄是否大于25:%d", [pred2 evaluateWithObject:sunnyzl], [pred2 evaluateWithObject:jack]);

看到这里我们会发现evaluateWithObject:方法返回的是一个BOOL值,如果符合条件就返回YES,不符合就返回NO。而即使是最简单的使用也有一些大用处,比如以前我们写判断手机号码、邮编等等,像我就喜欢用John Engelhart大神的RegexKitLite,然而由于年代久远需要导入libicucore.dylib库(xcode7为libicucore.tbd)且由于是mrc又需要添加-fno-objc-arc,至此我们才能使用。然而使用谓词让我们可以用同样简洁的代码实现相同的功能

例二:判断手机号是否正确

1

2

3

4

5

6- (BOOL)checkPhoneNumber:(NSString *)phoneNumber

{

NSString *regex = @"^[1][3-8]\\d{9}$";

NSPredicate *pred = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", regex];

return[pred evaluateWithObject:phoneNumber];

}

看到这里是不是感觉好爽,感觉以前所有的正则都可以这么匹配,但是谓词匹配正则时也是有缺点的,下面通过一个例子来看一下这个致命的缺点

例三:谓词匹配正则的缺点

(本意:检测字符串中是否有特殊字符)

1

2

3

4

5

6- (BOOL)checkSpecialCharacter:(NSString *)string

{

NSString *regex = @"[`~!@#$^&*()=|{}':;',\\[\\].<>/?~!@#¥……&*()——|{}【】‘;:”“'。,、?]";

NSPredicate *pred = [NSPredicate predicateWithFormat:@"SELF MATCHES %@", regex];

return[pred evaluateWithObject:string];

}

我们想要的效果是字符串中有特殊字符时就返回YES,然而梦想是美好的,现实是残酷的

让我们看看这悲催的结局

1

2

3

4NSString *testString = @"!";

NSLog(@"是否含有特殊字符:%d", [self checkSpecialCharacter:testString]);

//  当testString为一个特殊字符时,我们惊喜的发现输出为

//  是否含有特殊字符:1

看到这里我们心里猛然一喜,这tmd根本没问题嘛

让我们修改下testString的值

1

2

3

4NSString *testString = @"!~";

NSLog(@"%d", [self checkSpecialCharacter:testString]);

//  我们会发现悲催的结局来了输出为

//  是否含有特殊字符:0

再次修改testString的值

1

2

3

4NSString *testString = @"abc!~d";

NSLog(@"%d", [self checkSpecialCharacter:testString]);

//  我们会发现输出为

//  是否含有特殊字符:0

这总与我们的想法事与愿违,看到这里我们会发现谓词对正则并不像我们使用NSRegularExpression时匹配的那么好,究其原因是为什么呢?我们用NSRegularExpression时会发现匹配到一个结果时就会存入数组,再从匹配到的位置继续向下匹配。

然而NSPredicate并不会做这样的自动操作,我们最终发现在NSPredicate输入[`~!@#$^&*()=|{}':;',\[\].<>/?~!@#¥……&*()——|{}【】‘;:”“'。,、?]正则表达式时和写成^[`~!@#$^&*()=|{}':;',\[\].<>/?~!@#¥……&*()——|{}【】‘;:”“'。,、?]$的效果是一样的。

所以通过这个例子我们总结出来,只有在正则表达式为^表达式$时才使用谓词,而不是所有情况都使用。

那么我们是不是因为这一点就摒弃它了呢,答案是否定的。因为虽然NSPredicate有这么一点瑕疵,但是它总体带给我们的便利其实除了正则表达式匹配时的这个问题外是更多的。

2.使用谓词过滤集合

此部分是我们需要掌握的重点,因为从这里我们就可以看到谓词的真正的强大之处

其实谓词本身就代表了一个逻辑条件,计算谓词之后返回的结果永远为BOOL类型的值。而谓词最常用的功能就是对集合进行过滤。当程序使用谓词对集合元素进行过滤时,程序会自动遍历其元素,并根据集合元素来计算谓词的值,当这个集合中的元素计算谓词并返回YES时,这个元素才会被保留下来。请注意程序会自动遍历其元素,它会将自动遍历过之后返回为YES的值重新组合成一个集合返回。

其实类似于我们使用tableView设置索引时使用的下段代码

1

2

3

4- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView

{

return[self.cityGroup valueForKey:@"title"];

}

中的[self.cityGroup valueForKey:@"title"]。它的作用是遍历所有title并将得到的值组成新的数组。

NSArray提供了如下方法使用谓词来过滤集合

- (NSArray*)filteredArrayUsingPredicate:(NSPredicate *)predicate:使用指定的谓词过滤NSArray集合,返回符合条件的元素组成的新集合

NSMutableArray提供了如下方法使用谓词来过滤集合

- (void)filterUsingPredicate:(NSPredicate *)predicate:使用指定的谓词过滤NSMutableArray,剔除集合中不符合条件的元素

NSSet提供了如下方法使用谓词来过滤集合

- (NSSet*)filteredSetUsingPredicate:(NSPredicate *)predicate NS_AVAILABLE(10_5, 3_0):作用同NSArray中的方法

NSMutableSet提供了如下方法使用谓词来过滤集合

- (void)filterUsingPredicate:(NSPredicate *)predicate NS_AVAILABLE(10_5, 3_0):作用同NSMutableArray中的方法。

通过上面的描述可以看出,使用谓词过滤不可变集合和可变集合的区别是:过滤不可变集合时,会返回符合条件的集合元素组成的新集合;过滤可变集合时,没有返回值,会直接剔除不符合条件的集合元素

下面让我们来看几个例子:

例一:

1

2

3

4

5

6

7

8

9

10

11

12

13NSMutableArray *arrayM = [@[@20, @40, @50, @30, @60, @70] mutableCopy];

//  过滤大于50的值

NSPredicate *pred1 = [NSPredicate predicateWithFormat:@"SELF > 50"];

[arrayM filterUsingPredicate:pred1];

NSLog(@"arrayM:%@", arrayM);

NSArray *array = @[[ZLPersonModel personWithName:@"Jack"age:20 sex:ZLPersonSexMale],

[ZLPersonModel personWithName:@"Rose"age:22 sex:ZLPersonSexFamale],

[ZLPersonModel personWithName:@"Jackson"age:30 sex:ZLPersonSexMale],

[ZLPersonModel personWithName:@"Johnson"age:35 sex:ZLPersonSexMale]];

//  要求取出包含‘son’的元素

NSPredicate *pred2 = [NSPredicate predicateWithFormat:@"name CONTAINS 'son'"];

NSArray *newArray = [array filteredArrayUsingPredicate:pred2];

NSLog(@"%@", newArray);

输出为

1

2

3

4

5

6

7

82016-01-07 16:50:09.510 PredicteDemo[13660:293822] arrayM:(

60,

70

)

2016-01-07 16:50:09.511 PredicteDemo[13660:293822] (

"[name = Jackson, age = 30, sex = 0]",

"[name = Johnson, age = 35, sex = 0]"

)

从这个例子我们就可以看到NSPredicate有多么强大,如果让我们用其他的方法来实现又是一大堆if...else。

让我们来回顾一下上面的从第二个数组中去除第一个数组中相同的元素

例二:

1

2

3

4NSArray *filterArray = @[@"ab", @"abc"];

NSArray *array = @[@"a", @"ab", @"abc", @"abcd"];

NSPredicate *predicate = [NSPredicate predicateWithFormat:@"NOT (SELF IN %@)", filterArray];

NSLog(@"%@", [array filteredArrayUsingPredicate:predicate]);

输出为:

1

2

3

42016-01-07 13:17:43.669 PredicteDemo[6701:136206] (

a,

abcd

)

如果我们不用NSPredicate的话,肯定又是各种if...else,for循环等等。可以看出NSPredicate的出现为我们节省了大量的时间和精力。

3.在谓词中使用占位符参数

我们上面所有的例子中谓词总是固定的,然而我们在现实中处理变量时决定了谓词应该是可变的。下面我们来看看如果让谓词变化起来。

首先如果我们想在谓词表达式中使用变量,那么我们需要了解下列两种占位符:

%K:用于动态传入属性名

%@:用于动态设置属性值

其实相当于变量名与变量值

除此之外,还可以在谓词表达式中使用动态改变的属性值,就像环境变量一样

1

NSPredicate *pred = [NSPredicate predicateWithFormat:@"SELF CONTAINS $VALUE"];

上述表达式中,$VALUE是一个可以动态变化的值,它其实最后是在字典中的一个key,所以可以根据你的需要写不同的值,但是必须有$开头,随着程序改变$VALUE这个谓词表达式的比较条件就可以动态改变。

下面我们通过一个例子来看看这三个重要的占位符应该如何使用

例一:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23NSArray *array = @[[ZLPersonModel personWithName:@"Jack"age:20 sex:ZLPersonSexMale],

[ZLPersonModel personWithName:@"Rose"age:22 sex:ZLPersonSexFamale],

[ZLPersonModel personWithName:@"Jackson"age:30 sex:ZLPersonSexMale],

[ZLPersonModel personWithName:@"Johnson"age:35 sex:ZLPersonSexMale]];

//  定义一个property来存放属性名,定义一个value来存放值

NSString *property = @"name";

NSString *value = @"Jack";

//  该谓词的作用是如果元素中property属性含有值value时就取出放入新的数组内,这里是name包含Jack

NSPredicate *pred = [NSPredicate predicateWithFormat:@"%K CONTAINS %@", property, value];

NSArray *newArray = [array filteredArrayUsingPredicate:pred];

NSLog(@"newArray:%@", newArray);

//  创建谓词,属性名改为age,要求这个age包含$VALUE字符串

NSPredicate *predTemp = [NSPredicate predicateWithFormat:@"%K > $VALUE", @"age"];

// 指定$SUBSTR的值为 25    这里注释中的$SUBSTR改为$VALUE

NSPredicate *pred1 = [predTemp predicateWithSubstitutionVariables:@{@"VALUE": @25}];

NSArray *newArray1 = [array filteredArrayUsingPredicate:pred1];

NSLog(@"newArray1:%@", newArray1);

//  修改 $SUBSTR的值为32,  这里注释中的SUBSTR改为$VALUE

NSPredicate *pred2 = [predTemp predicateWithSubstitutionVariables:@{@"VALUE": @32}];

NSArray *newArray2 = [array filteredArrayUsingPredicate:pred2];

NSLog(@"newArray2:%@", newArray2);

输出为

1

2

3

4

5

6

7

8

9

10

112016-01-07 17:28:02.062 PredicteDemo[14542:309494] newArray:(

"[name = Jack, age = 20, sex = 0]",

"[name = Jackson, age = 30, sex = 0]"

)

2016-01-07 17:28:02.063 PredicteDemo[14542:309494] newArray1:(

"[name = Jackson, age = 30, sex = 0]",

"[name = Johnson, age = 35, sex = 0]"

)

2016-01-07 17:28:02.063 PredicteDemo[14542:309494] newArray2:(

"[name = Johnson, age = 35, sex = 0]"

)

推荐阅读更多精彩内容

  • 首先,我们需要知道何谓谓词,让我们看看官方的解释:The NSPredicate class is used to...
    旭日飞扬阅读 251评论 1 0
  • 转载自:http://www.cocoachina.com/ios/20160111/14926.html 1、大...
    一笔春秋阅读 473评论 0 0
  • 前言 有时我们需要在一大段长文本中过滤出我们需要的字段,或者检验该文本是否符合要求(该文本是否是邮箱,链接,电话号...
    進无尽阅读 170评论 0 1
  • ✨建议收藏,用到时候一查就明白了 --xx_cc. 一、NSPredicate基本语句 只要我们使用谓词(NSPr...
    xx_cc阅读 4,252评论 6 51
  • 什么是谓词查询 NSPredicate类是用来定义逻辑条件约束的获取或内存中的过滤搜索。 可以使用谓词表示逻辑条件...
    奔跑的_猿阅读 275评论 0 1