由于觉得网上对于NSPredicate讲解比较粗略,所以打算先看文档,奈何英语水平有限,故先翻译一遍,加深理解(如有错误,欢迎指正)。
概览
NSPredicate类是用来定义逻辑条件约束的获取或内存中的过滤搜索。
您可以使用谓词来表示逻辑条件,用于描述对象持久性存储在内存中的对象过滤。虽然从 NSComparisonPredicate, NSCompoundPredicate, 和 NSExpression的实例直接创建谓词是常见的,但是你会经常用NSPredicate的类方法解析的格式字符串来创建谓词。谓词格式字符串的例子包括:
-
简单的比较, 比如
grade
==
"7"
或者firstName
like
"Shaffiq"
-
不区分大小写和音调的查找, 比如
name
contains[cd]
"itroen"
-
逻辑运算, 比如
(firstName like "Mark")
OR
(lastName like "Adderley")
-
In OS X v10.5 and later, you can create €œbetween€ predicates such as
date
between
{$YESTERDAY, $TOMORROW}
.
-
group.name like "work*"
-
ALL children.age > 12
-
ANY children.age > 12
您也可以创建包含变量的谓词,那样谓词就可以在运行时(runtime)替换具体值之前预先定义。在os x v10.4,含变量的谓词,估算是一个两步骤的过程 (see predicateWithSubstitutionVariables: and evaluateWithObject:)。在os x v10.5及以后,你可以使用 evaluateWithObject:substitutionVariables:,它结合了这些步骤。
任务
创建谓词:
+ predicateWithFormat:
+ predicateWithFormat:argumentArray:
+ predicateWithFormat:arguments:
– predicateWithSubstitutionVariables:
+ predicateWithValue:
+ predicateWithBlock:
评估一个谓词:
– evaluateWithObject:
– evaluateWithObject:substitutionVariables:
获取字符串表现形式:
– predicateFormat
类方法
1.predicateWithBlock:
创建并返回一个谓词,评估使用指定的块对象和绑定的字典。
+ (NSPredicate *)predicateWithBlock:(BOOL (^)(id evaluatedObject, NSDictionary *bindings))block;
参数
block
block施加于被评估的对象。
block带有两个参数:
evaluatedObject:被评估的对象。
bindings:替换变量的字典。字典必须包含接收器中所有变量的键值对。
如果evaluatedObject的计算结果为true,该块返回YES,否则为NO 。
返回值
一个评估对象使用了块的谓词。
特殊考虑
在os X v10.6.Core Data 在内存和原子存储中支持这个方法,但是基于SQLite的存储是不支持的。
有效性
4.0及以后有效
声明于
NSPredicate.h
2.predicateWithFormat:
由给定的格式和解析结果创建一个新的字符串来创建并返回一个新的谓词。
+ (NSPredicate *)predicateWithFormat:(NSString *)format, ...
参数
format:新谓词的格式字符串。
...:以逗号分隔的参数列表。
返回值
一个新的谓词,由创建一个新的格式字符串并且解析这个结果(即那个新的格式字符串)所得。
讨论
格式字符串的格式和变量替换的限制,请参阅 Predicate Format String Syntax。
有效性
IOS 3.0及以后有效。
相关的代码例子
声明于
NSPredicate.h
3.predicateWithFormat:argumentArray:
创建并且返回一个新的谓词,通过把数组里面的值传入到格式字符串中并且解析所得。
+ (NSPredicate *)predicateWithFormat:(NSString *)predicateFormat argumentArray:(NSArray*)arguments
参数
predicateFormat:新谓词的格式字符串。
arguments:要代入格式字符串的数组。代入的时候数组里的值按照数组里的顺序。
一个新的谓词,通过把数组中的值按顺序代入格式字符串并解析所得。
讨论
格式字符串的格式和变量替换的限制,请参阅 Predicate Format String Syntax。
有效性
IOS 3.0及以后有效。
声明于NSPredicate.h
4.predicateWithFormat:arguments:
创建并且返回一个新的谓词,通过把参数列表中的参数代入格式字符串中并且解析得到。
参数
predicateFormat:新谓词的格式字符串。
argList:代入格式谓词中的内容。参数列表代入顺序即它们出现在列表中的顺序。返回值
一个新的谓词,通过把参数列表中的值按顺序代入格式字符串并解析所得。
格式字符串的格式和变量替换的限制,请参阅 Predicate Format String Syntax。
有效性
IOS 3.0及以后有效。
声明于NSPredicate.h
5.predicateWithValue:
有效性
IOS 3.0及以后有效。
声明于NSPredicate.h
实例方法
1.evaluateWithObject:
IOS 3.0及以后有效。
声明于NSPredicate.h
返回一个给定的BOOL值,用于指示一个给定的对象在一个给定的变量字典中的值代入后是否匹配接收者的特殊条件。
evaluateWithObject:
"返回的结果一样。此方法在反复评估不同变量替换的谓词情况下被优化。
接收者的格式字符串
特殊考虑
用这个方法返回的字符串不能够保证和使用predicateWithFormat:等方法返回的字符串一样。你不能用这个方法来创建一个谓词的持久化表示,但是你可以用它来再现原始谓词。如果你需要一个谓词的持久化表示,你可以创建一个archive(NSPredicate采用NSCoding协议)
有效性
IOS 3.0及以后有效。
声明于NSPredicate.h
4.predicateWithSubstitutionVariables:
有效性
IOS 3.0及以后有效。
声明于NSPredicate.h