Show Menu
トピック×

文字列関数

プロファイルクエリ言語(PQL)オファー関数を使用して、文字列とのやり取りを簡単にします。 その他のPQL機能の詳細については、「 プロファイルクエリ言語の概要 」を参照してください。

いいね!

この like 関数は、文字列が指定したパターンと一致するかどうかを判断するために使用されます。
形式
{STRING_1} like {STRING_2}

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列と照合する式です。 式を作成する際にサポートされる特殊文字は2つあります。 % _
  • % は、0個以上の文字を表すために使用します。
  • _ は、1文字を表すために使用します。
次のPQLクエリは、「es」というパターンを含むすべての市区町村を取得します。
city like "%es%"

次で始まる

この startsWith 関数は、指定したサブ文字列を持つ文字列開始ーかどうかを判定するために使用されます。
形式
{STRING_1}.startsWith({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリは、名前の開始に「Joe」が含まれる場合、大文字と小文字の区別を持って決定します。
person.name.startsWith("Joe")

次で始まらない

この doesNotStartWith 関数は、文字列が指定したサブ文字列と開始していないかどうかを判定するために使用されます。
形式
{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリは、名前が「Joe」と開始していない場合、大文字と小文字の区別を持って決定します。
person.name.doesNotStartWith("Joe")

次の語句で終わる

この endsWith 関数は、文字列が指定したサブ文字列で終わるかどうかを判断するために使用されます。
形式
{STRING_1}.endsWith({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリでは、ユーザーの電子メールアドレスが「.com」で終わる場合、大文字と小文字の区別がなされます。
person.emailAddress.endsWith(".com")

次の語句で終わらない

この doesNotEndWith 関数は、文字列が指定したサブ文字列で終わらないかどうかを判断するために使用されます。
形式
{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリでは、ユーザーの電子メールアドレスが「.com」で終わらない場合、大文字と小文字の区別があります。
person.emailAddress.doesNotEndWith(".com")

Contains

この contains 関数は、文字列に指定したサブ文字列が含まれているかどうかを調べるために使用されます。
形式
{STRING_1}.contains({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリでは、ユーザーの電子メールアドレスに文字列「2010@gm」が含まれている場合、大文字と小文字の区別がなされます。
person.emailAddress.contains("2010@gm")

次を含まない

この doesNotContain 関数は、文字列に指定したサブ文字列が含まれていないかどうかを調べるために使用されます。
形式
{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列内で検索する文字列です。
{BOOLEAN}
チェックで大文字と小文字が区別されるかどうかを指定するオプションのパラメーター。 デフォルトではtrueに設定されています。
次のPQLクエリでは、ユーザーの電子メールアドレスに文字列「2010@gm」が含まれていない場合、大文字と小文字の区別があります。
person.emailAddress.doesNotContain("2010@gm")

次と等しい

この equals 関数は、文字列が指定した文字列と等しいかどうかを判断するために使用されます。
形式
{STRING_1}.equals({STRING_2})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列と比較する文字列です。
次のPQLクエリは、名前が「John」である場合、大文字と小文字の区別を持って決定します。
person.name.equals("John")

次と等しくない

この notEqualTo 関数は、文字列が指定した文字列と等しくないかどうかを判定するために使用されます。
形式
{STRING_1}.notEqualTo({STRING_2})

引数
説明
{STRING_1}
チェックを実行する文字列です。
{STRING_2}
最初の文字列と比較する文字列です。
次のPQLクエリは、名前が「John」でない場合、大文字と小文字の区別を持って決定します。
person.name.notEqualTo("John")

一致

この matches 関数は、文字列が特定の正規式と一致するかどうかを判別するために使用されます。 正規式でのパターンの一致について詳しくは、 このドキュメント を参照してください。
形式
{STRING_1}.matches(STRING_2})

次のPQLクエリは、「John」という名前の開始の場合、大文字と小文字を区別せずに決定します。
person.name.matches("(?i)^John")

正規式グループ

この regexGroup 関数は、提供される正規式に基づいて特定の情報を抽出するために使用されます。
形式
{STRING}.regexGroup({EXPRESSION})

次のPQLクエリを使用して、電子メールアドレスからドメイン名を抽出します。
emailAddress.regexGroup("@(\w+)", 1)

次の手順

文字列関数について学習したので、PQLクエリ内で使用できます。 その他のPQL関数の詳細については、 プロファイルクエリ言語の概要を参照してください