ReplaceRegEx - スクリプトおよびチャート関数
ReplaceRegEx() は、入力文字列と指定された正規表現パターン間の 1 つ以上の一致を置き換えた文字列を返します。一致するテキストを置き換えるテキストは、to_str 引数で指定されます。関数は左から右に動作しますが、負の occurrence 値を指定すると、関数は右から左に読み取られます。
この関数は、大文字と小文字を区別する正規表現操作を実行します。代わりに、バリアント ReplaceRegExI() を使用して、大文字と小文字を区別しない正規表現操作を実行することもできます。
構文:
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 を返します。この例では、正規表現パターンに一致する入力文字列のすべてのテキストが新しいテキストに置き換えられます。 |
ReplaceRegEx('abc123','[0-9]','x',1) | abcx23 を返します。入力文字列と正規表現パターンの間で最初に一致した部分のみが置き換えられます。 |
ReplaceRegEx('abc123','[0-9]','x',4) | abc123 を返します。入力文字列と正規表現パターンの間には一致する可能性のあるものは 3 つだけなので、変更は実行されません。 |
ReplaceRegEx('ABC123','[a-c]','5') | ABC123 を返します。ReplaceRegEx() は大文字と小文字を区別するため変更は実行されず、大文字と小文字を区別しないバリアントは使用されません。 |
ReplaceRegExI('ABC123','[a-c]','5') | 555123 を返します。関数の大文字と小文字を区別しないバリアント ReplaceRegExI() が使用されます。 |
使用に適しているケース
特にデータ内に複雑なパターンが存在する場合、ReplaceRegEx() を使用してテキストを変更し、書式設定やコンプライアンス標準を満たすことができます。たとえば、電話番号の文字列を再フォーマットして、数値のみが含まれるようにすることができます。
必要に応じて、この関数を使用して、個人を特定できる情報 (PII) などの機密情報をマスクし、アプリを分析するユーザーに表示されないようにすることもできます。