swift NSPredicateの引数について

Question

swiftを勉強中です。

以下のサイトに記述されているコードが理解できません。

https://qiita.com/H_Crane/items/e784a5f7c4fb5e6470e6

【日本語判定】の項目にて

NSPredicate(format: "SELF MATCHES %@", range).evaluate(with: self)

NSPredicateの公式リファレンスを読んでも内容が理解できませんでしたので誰か解説をお願いします。
特に引数である"SELF MATCHES %@"の意味がわかりません。

よろしくお願いします。

公式リファレンス　NSPredicate
https://developer.apple.com/documentation/foundation/nspredicate

Answer 1

特に引数である"SELF MATCHES %@"の意味がわかりません。

SELF（selfを渡しているのでString自身）が%@（引数のrangeが割り当てられる）とMATCHES（一致）するかどうか。

日本語ドキュメントより、

MATCHES演算子は、次の例に示すようにICUの正規表現パッケージを使用します。

ということなので、rangeが表す正規表現とself(String自身)が一致するかどうか、ということになります。

Comments

[L85A2]

日本語のドキュメントがあるのですね

回答ありがとうございます。

Answer 2

引用されているサイト

[Swift]iOSのデフォルトの関数を活用した Validation String Extension集

から少しコードを抜粋しますが、

extension String {

    /// 「漢字」かどうか
    var isKanji: Bool {
        let range = "^[\u{3005}\u{3007}\u{303b}\u{3400}-\u{9fff}\u{f900}-\u{faff}\u{20000}-\u{2ffff}]+$"
        return NSPredicate(format: "SELF MATCHES %@", range).evaluate(with: self)
    }

この中の"SELF MATCHES %@" がどういう意味になるかというと、

まず SELF は Literals より、

SELF
Represents the object being evaluated.

つまり評価対象自身、この場合は evaluate(with: self) の self となります。
このコードは String の extension なので、 self は String です。

MATCHES は String Comparisons より、

MATCHES
The left hand expression equals the right hand expression using a regex-style comparison according to ICU v3 (for more details see the ICU User Guide for Regular Expressions).

ですから、左辺の SELF（対象文字列）が右辺の正規表現を満たすかどうかをチェックしてます。

右辺は %@ になっていますが、 Parser Basics にある通り、

The format string supports printf-style format specifiers such as %x (see Formatting String Objects). Two important format specifiers are %@ and %K.

%@ is a var arg substitution for an object value—often a string, number, or date.

printf関数のようなパラメータ展開を行います。

NSPredicate(format: "SELF MATCHES %@", range)

なので %@ は range、つまり

"^[\u{3005}\u{3007}\u{303b}\u{3400}-\u{9fff}\u{f900}-\u{faff}\u{20000}-\u{2ffff}]+$"

です。

これは正規表現です。

結局、対象文字列が上記の正規表現を満たすかどうかチェックしている、ということになります。

Comments

[L85A2]

丁寧な解説ありがとうございます。
Predicate Programming Guide事体知らなかったので、URLまで記述していただて助かりました。

[daisuke7]

どういたしまして。

でも、質問に挙げていた NSPredicate のページに
"For a complete syntax reference, refer to the Predicate Programming Guide."
としてリンクありますよ:)

[L85A2]

英語アレルギー直しておきますorz