字串函式

Last update: Tue Nov 14 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Segments

建立對象：

User

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")

NOTE

如果您使用規則運算式函式，例如 \w，您必須逸出反斜線字元。因此，與其直接撰寫 \w，您必須加入額外的反斜線並寫入 \\w.

規則運算式群組

此 regexGroup 函式是用來根據提供的規則運算式擷取特定資訊。

格式

{STRING}.regexGroup({EXPRESSION})

範例

以下PQL查詢用於從電子郵件地址中擷取網域名稱。

emailAddress.regexGroup("@(\\w+)", 1)

NOTE

如果您使用規則運算式函式，例如 \w，您必須逸出反斜線字元。因此，與其直接撰寫 \w，您必須加入額外的反斜線並寫入 \\w.

後續步驟

現在您已瞭解字串函式，可以在PQL查詢中使用它們。如需其他PQL函式的詳細資訊，請參閱設定檔查詢語言概觀.

recommendation-more-help

770bc05d-534a-48a7-9f07-017ec1e14871