ReplaceRegEx - 指令碼與圖表函數
ReplaceRegEx() 會在取代輸入字串與指定規則運算式模式之間的一或多個相符項後傳回一個字串。取代相符文字的文字在 to_str 引數中指定。該函數從左至右運作,但如果指定負 occurrence 值,則函數從右至左讀取。
此函數執行區分大小寫的 Regex 操作。您也可以使用變體 ReplaceRegExI() 來執行不區分大小寫的 Regex 操作。
語法:
ReplaceRegEx (text, regex, to_str [, occurrence])
傳回的資料類型: 字串
引數 | 描述 |
---|---|
text | 您想要用 to_str 中的新文字全部或部分取代的輸入字串文字。 |
regex | 定義何時取代文字的規則運算式。將取代此引數和 text 引數之間的相符項。 |
to_str | 您想要用來取代 text 中現有內容的新文字。 |
occurrence |
要取代為新文字的相符項 (輸入文字和規則表達式之間) 數量。 此為選用引數。如果省略,預設值為 0。當使用值 0 或省略引數時,text 和 regex 之間的所有相符項都會取代為 to_str。 您可以為 occurrence 指定負值以從右到左識別相符項。 |
範例 | 結果 |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | 傳回 abcxxx。在此範例中,輸入字串中與 Regex 模式相符的所有文字都會取代為新文字。 |
ReplaceRegEx('abc123','[0-9]','x',1) | 傳回 abcx23。僅取代輸入字串和 Regex 模式之間第一次出現的相符項。 |
ReplaceRegEx('abc123','[0-9]','x',4) | 傳回 abc123。輸入字串和 Regex 模式之間只有三種可能的相符項,因此不執行任何修改。 |
ReplaceRegEx('ABC123','[a-c]','5') | 傳回 ABC123。不執行任何修改,因為 ReplaceRegEx() 區分大小寫,且未使用不區分大小寫的變體。 |
ReplaceRegExI('ABC123','[a-c]','5') | 傳回 555123。使用不區分大小寫的函數變體 ReplaceRegExI()。 |
使用情境
您可以使用 ReplaceRegEx() 修改文字以滿足格式和合規性標準,尤其是當資料中存在複雜模式時。例如,您可以對電話號碼字串進行重新格式設定,以便僅包含數字值。
如果需要,您還可以使用此函數來遮罩敏感資訊,例如個人識別資訊 (PII),以便分析應用程式的使用者不會看到這些資訊。