Profile Query Language (PQL)提供可讓您更輕鬆與字串互動的函式。 如需其他PQL函式的詳細資訊,請參閱 Profile Query Language 概觀.
此 like
函式來判斷字串是否符合指定的模式。
格式
{STRING_1} like {STRING_2}
引數 | 說明 |
---|---|
{STRING_1} |
執行檢查的字串。 |
{STRING_2} |
比對第一個字串的運算式。 建立運算式有兩個支援的特殊字元: % 和 _ .
|
範例
以下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
函式來決定字串是否包含指定的子字串。
格式
{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")
如果您使用規則運算式函式,例如 \w
,您 必須 逸出反斜線字元。 因此,與其直接撰寫 \w
,您必須加入額外的反斜線並寫入 \\w
.
此 regexGroup
函式是根據提供的規則運算式來擷取特定資訊。
格式
{STRING}.regexGroup({EXPRESSION})
範例
以下PQL查詢用於從電子郵件地址中擷取網域名稱。
emailAddress.regexGroup("@(\\w+)", 1)
如果您使用規則運算式函式,例如 \w
,您 必須 逸出反斜線字元。 因此,與其直接撰寫 \w
,您必須加入額外的反斜線並寫入 \\w
.
現在您已瞭解字串函式,可以在PQL查詢中使用它們。 如需其他PQL功能的詳細資訊,請參閱 設定檔查詢語言概觀.