字串函式 string-functions

concat(<string>,<string>)

concat(<listString>)

傳回字串。

concat("Hello","World")

傳回「HelloWorld」。

concat(["Hello"," ","World"])

傳回「Hello World」。

• 字串

contain(<string>,<string>)

傳回布林值。

contain("rowing is great", "great")

傳回true。

containIgnoreCase(<string>,<string>)

傳回布林值。

containIgnoreCase("rowing is great", "GREAT")

傳回true。

endWith(<string>,<string>)

傳回布林值。

endWith("Hello World", "World")

傳回true。

endWith("Hello World", "Hello")

傳回false。

endWithIgnoreCase(<string>,<string>)

傳回布林值。

endWithIgnoreCase("rowing is great", "AT")

傳回true。

• 字串

equalIgnoreCase(<string>,<string>)

傳回布林值。

equalIgnoreCase("rowing is great", "rowing is GREAT")

傳回true。

indexOf(<string>,<string>)

傳回整數。

indexOf("Hello", "l")

傳回2。

說明：

在「Hello」中，「l」的第一次出現位置為位置2。

• 字串

isEmpty(<string>)

傳回布林值。

isEmpty("")

傳回true。

isEmpty("Hello World")

傳回false。

isEmpty(<null>)

傳回false。

• 字串

isNotEmpty(<string>)

傳回布林值。

isNotEmpty("")

傳回false。

isNotEmpty("hello")

傳回true。

lastIndexOf(<string>,<string>)

傳回整數。

lastIndexOf("Hello", "l")

傳回3。

說明：

在「Hello」中，「l」的最後一次出現位於位置3。

• 字串

length(<string>)

傳回整數。

length("Hello World")

傳回11。

• 字串

lower(<string>)

傳回字串。

lower("A")

傳回「a」。

matchRegExp(<string>,<string>)

傳回布林值。

matchRegExp("12345", "\\d+")

傳回true。

• 字串

notEqualIgnoreCase(<string>,<string>)

傳回布林值。

replace(<base>,<target>,<replacement>)

傳回字串。

replace("Hello World", "l", "x")

傳回「Hexlo World」。

具有RegExp的​範例：

由於目標引數是RegExp，因此根據您要取代的字串，您可能需要將部分字元逸出。 其範例如下：

• 要評估的字串： |OFFER_A|OFFER_B
• 由設定檔屬性#{ExperiencePlatform.myFieldGroup.profile.myOffers}提供
• 要取代的字串： |OFFER_A
• 字串取代為： ''
• 您必須在|字元前新增\\。

運算式為：

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|OFFER_A', '')

傳回的字串是： |OFFER_B

您也可以建置要由指定屬性取代的字串：

replace(#{ExperiencePlatform.myFieldGroup.profile.myOffers}, '\\|' + #{ExperiencePlatform.myFieldGroup.profile.myOfferCode}, '')

replaceAll(<baseString>,<sourceString>,<replacementString>)

傳回字串。

replaceAll("Hello World", "l", "x")

傳回「Hexxo Worxd」。

由於目標引數是RegExp，因此根據您要取代的字串，您可能需要將部分字元逸出。 請參考取代函式中的範例。

split(<input string>, <separator string>)

傳回listString。

split("A_B_C", "_")

傳回["A","B","C"]

具有下列值的事件欄位「event.appVersion」範例：「20.45.2.3434」

split(@event{event.appVersion}, "\\.")

傳回["20", "45", "2", "3434"]

startWith(<string>,<string>)

傳回布林值。

startWith("Hello World", "Hello")

傳回true。

startWith("Hello World", "World")

傳回false。

startWithIgnoreCase(<string>,<string>)

傳回布林值。

startWithIgnoreCase("rowing is great", "RO")

傳回true。

substr(<string>,<beginIndex>)

substr(<string>,<beginIndex>,<endIndex>)

傳回字串。

substr("Hello World",6)

傳回「World」。

substr("Hello World", 0, 5)

傳回「Hello」。

trim(<string>)

傳回字串。

trim(" Hello ")

傳回「Hello」。

upper(<string>)

傳回字串。

upper("b")

傳回「B」。

uuid()

傳回字串。

uuid()

傳回「79e70b7f-8a85-400b-97a1-9f9826121553」。

本節包含結構化知識，用於支援與本主題相關的解譯、擷取和問答。

如需完整瞭解，此資訊應結合本頁的檔案。 兩者皆非獨立來源；頁面說明功能，本節提供額外內容，以協助去除術語、意圖、適用性和限制條件的歧義。

• TL；DR：​此頁面記錄了AJO歷程運算式中可用的所有字串函式，涵蓋文字搜尋、比較、轉換、擷取、驗證、取代、分割和產生唯一識別碼。

意圖：

• 使用concat串連兩個或多個字串
• 使用contain或containIgnoreCase搜尋字串中的子字串（區分大小寫或不區分大小寫）
• 比較兩個字串，但忽略使用equalIgnoreCase或notEqualIgnoreCase的大小寫
• 使用startWith、endWith及其不區分大小寫的變體，檢查字串的開頭或結尾是否為特定首碼或尾碼
• 使用substr依索引位置擷取子字串
• 使用replace或replaceAll取代字串中模式的第一次或所有事件
• 使用split以分隔符號將字串分割為權杖清單
• 使用uuid針對唯一識別碼需求產生隨機UUID
• 使用isEmpty或isNotEmpty檢查字串是否為空白或非空白

字彙表：

• RegExp：在replace、replaceAll和matchRegExp中當作目標引數使用的規則運算式模式 — 特殊字元必須以\\逸出
• UUID：通用唯一識別碼 — uuid()傳回的隨機產生字串識別碼
• substr：透過指定開始索引和選擇性結束索引（以零為基礎）來擷取字串的一部分

護欄：

• 將replace與replaceAll中的target引數視為RegExp；特殊字元（如|、.）必須以\\逸出
• replace僅取代第一個相符專案；使用replaceAll取代每個專案
• isEmpty傳回False作為Null值（不是True）；Null不被視為空字串
• 找不到相符專案時，indexOf和lastIndexOf會傳回–1
• 字串索引位置以零為基礎（第一個字元位於位置0）

術語：

• 正式名稱：字串函式 — 首字母縮寫：none — 變體：文字函式，字串操作函式
• 同義字： “contain” = “substring check”；“split” = “tokenize string”；“trim” = “strip whitespace”
• 請勿混淆：「replace」（僅限第一次發生）≠「replaceAll」（所有發生）
• 請勿混淆：「indexOf」（第一個發生位置）≠「lastIndexOf」（最後一個發生位置）
• 請勿混淆：「isEmpty」（僅對零長度字串為true）≠null檢查（對null，isEmpty會傳回false）
• 請勿混淆：「equalIgnoreCase」（在相等忽略大小寫時傳回true）≠「notEqualIgnoreCase」（在不同的忽略大小寫時傳回true）

常見問題集：

• 問：如何檢查字串是否包含子字串（不論大小寫為何）？ — 使用containIgnoreCase("myString", "searchTerm")，如果在任何情況下都能找到搜尋字詞，則會傳回true。
• 問：replace與replaceAll之間有何差異？ — replace僅取代第一個相符專案；replaceAll取代字串中的每個專案。
• 問：為什麼我需要在replace中逸出|字元？ — 目標引數會被視為規則運算式；|是特殊的RegExp字元，必須以\\|逸出，才能被視為常值管道。
• 問： isEmpty是否為null傳回true？ — No，isEmpty傳回False代表Null；它只傳回True代表零長度字串""。
• 問：如何從「20.45.2.3434」之類的版本字串擷取主要版本號碼？ — 使用getListItem(split(@event{event.appVersion}, "\\."), 0)以點分割並擷取第一個元素。
• 問：如何在歷程運算式中產生唯一識別碼？ — 使用uuid()，這會傳回隨機產生的UUID字串，而不需要引數。