字串函式

Profile Query Language (PQL)提供可簡化與字串互動的函式。 如需其他PQL函式的詳細資訊，請參閱Profile Query Language 總覽。

讚

like函式是用來判斷字串是否符合指定的布林值模式。

格式

{STRING_1} like {STRING_2}

範例

下列PQL查詢會擷取包含「es」模式的所有城市。

city like "%es%"

開頭為

startsWith函式是用來判斷字串的開頭是否為指定的子字串做為布林值。

格式

{STRING_1}.startsWith({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷人員名稱是否以「Joe」開頭。

person.name.startsWith("Joe")

開頭不是

doesNotStartWith函式是用來判斷字串的開頭是否不是以指定的子字串做為布林值。

格式

{STRING_1}.doesNotStartWith({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷人員名稱是否以「Joe」開頭。

person.name.doesNotStartWith("Joe")

結尾為

endsWith函式是用來判斷字串的結尾是否為指定的子字串做為布林值。

格式

{STRING_1}.endsWith({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷此人的電子郵件地址是否以「.com」結尾。

person.emailAddress.endsWith(".com")

結尾不是

doesNotEndWith函式是用來判斷字串的結尾是否不是指定的子字串做為布林值。

格式

{STRING_1}.doesNotEndWith({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷個人的電子郵件地址是否以「.com」結尾。

person.emailAddress.doesNotEndWith(".com")

包含

contains函式是用來判斷字串是否包含指定的子字串做為布林值。

格式

{STRING_1}.contains({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷個人的電子郵件地址是否包含「2010@gm」字串。

person.emailAddress.contains("2010@gm")

不包含

doesNotContain函式是用來判斷字串是否不包含指定的子字串做為布林值。

格式

{STRING_1}.doesNotContain({STRING_2}, {BOOLEAN})

範例

下列PQL查詢會區分大小寫，判斷個人的電子郵件地址是否不包含字串「2010@gm」。

person.emailAddress.doesNotContain("2010@gm")

等於

equals函式是用來判斷字串是否等於指定的布林字串。

格式

{STRING_1}.equals({STRING_2})

範例

下列PQL查詢會區分大小寫判斷此人的姓名是否為「John」。

person.name.equals("John")

不等於

notEqualTo函式是用來判斷字串是否不等於指定的布林值字串。

格式

{STRING_1}.notEqualTo({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功能的詳細資訊，請參閱Profile Query Language概觀。