Class

NSPredicate

A definition of logical conditions for constraining a search for a fetch or for in-memory filtering. フェッチ（主メモリ呼び出し）のためのまたはインメモリフィルタのための検索に制約を加えるための論理条件の定義。

Declaration 宣言

class NSPredicate : NSObject

Overview 概要

Predicates represent logical conditions, which you can use to filter collections of objects. Although it’s common to create predicates directly from instances of NSComparisonPredicate, NSCompoundPredicate, and NSExpression, you often create predicates from a format string that the class methods parse on NSPredicate. Examples of predicate format strings include: 述部は論理条件を表します、それはあなたがオブジェクトのコレクションをフィルタするのに使用できます。普通は述部をNSComparisonPredicate、NSCompoundPredicate、そしてNSExpressionのインスタンスから直接に作成するとはいえ、あなたはしばしば述部それらをある書式設定文字列から作成します、それはクラスメソッドがNSPredicate上で構文解析します。述部書式設定文字列の例は以下を含みます：

Simple comparisons, such as grade == “7” or firstName like “Juan” 単純な比較、例えばgrade == “7”またはfirstName like “Juan”
Case- and diacritic-insensitive lookups, such as name contains[cd] “stein” ケースおよび区別的発音符に配慮しない検索、例えばname contains[cd] “stein”
Logical operations, such as (firstName like “Mei”) OR (lastName like “Chen”) 論理演算、例えば(firstName like “Mei”) OR (lastName like “Chen”)
Temporal range constraints, such as date between {$YESTERDAY, $TOMORROW} 時を表す範囲の制約、例えばdate between {$YESTERDAY, $TOMORROW}
Relational conditions, such as group.name like “work*" 関係条件、例えばgroup.name like “work*"
Aggregate operations, such as @sum.items.price < 1000 集合演算、例えば@sum.items.price < 1000

For a complete syntax reference, refer to the Predicate Programming Guide. 完全な構文参照のために、Predicate Programming Guideを参照してください。

You can also create predicates that include variables using the evaluate(with:substitutionVariables:) method so that you can predefine the predicate before substituting concrete values at runtime.

Topics 話題

Creating a Predicate 述部を作成する

init(format: String, argumentArray: [Any]?)

Creates a predicate by substituting the values in a specified array into a format string and parsing the result. 指定された配列の中の値を書式設定文字列へと置き換えてその結果を構文解析することによって、ある述部を作成します。

init(format: String, arguments: CVaListPointer)

Creates a predicate by substituting the values in an argument list into a format string and parsing the result. 引数リストの中の値を書式設定文字列へと置き換えてその結果を構文解析することによって、ある述部を作成します。

init(format: String, CVarArg...)

func withSubstitutionVariables([String : Any]) -> Self

Returns a copy of the predicate and substitutes the predicates variables with specified values from a specified substitution variables dictionary. 述部のコピーを返します、述部の変数をある指定された置換変数辞書からの指定される値で置き換えます。

init(value: Bool)

Creates and returns a predicate that always evaluates to a specified Boolean value. 常にある指定されたブール値に評価する述部を作成して返します。

init(block: (Any?, [String : Any]?) -> Bool)

Creates a predicate that evaluates using a specified block object and bindings dictionary. ある述部を作成します、それは指定されたブロックオブジェクトと束縛辞書を使って評価します。

init?(fromMetadataQueryString: String)

Creates a predicate with a metadata query string. 述部をメタデータクエリ文字列で作成します。

Evaluating a Predicate 述部を評価する

func evaluate(with: Any?) -> Bool

Returns a Boolean value that indicates whether the specified object matches the conditions that the predicate specifies. あるブール値を返します、それは指定されたオブジェクトがこの述部が指定する条件に合致するかどうかを指し示します。

func evaluate(with: Any?, substitutionVariables: [String : Any]?) -> Bool

Returns a Boolean value that indicates whether the specified object matches the conditions that the predicate specifies after substituting in the values from a specified variables dictionary. あるブール値を返します、それはある指定された変数辞書からの値において置換する後に、指定されたオブジェクトがこの述部が指定する条件に合致するかどうかを指し示します。

func allowEvaluation()

Forces a securely decoded predicate to allow evaluation. ある安全にデコードされた述部に、評価を許可するように強制します。

Getting a String Representation 文字列表現を取得する

var predicateFormat: String

The predicate's format string. 述部のもつ書式設定文字列。

Relationships 関係

Inherits From 継承元

NSObject