Show Menu
主題×

字串函式

描述檔查詢語言(PQL)提供函式,讓字串互動更簡單。 有關其他PQL函式的詳細資訊,請參閱「配置檔案查 詢語言」概述

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

規則運算式群組

該函 regexGroup 數用於根據所提供的規則運算式提取特定資訊。
格式
{STRING}.regexGroup({EXPRESSION})

範例
以下PQL查詢用於從電子郵件地址中抽取域名。
emailAddress.regexGroup("@(\w+)", 1)

後續步驟

現在您已瞭解字串函式,可在PQL查詢中使用它們。 有關其他PQL函式的詳細資訊,請閱讀配置式查 詢語言概述