ReplaceRegEx — funkcja skryptu i funkcja wykresu
Funkcja ReplaceRegEx() zwraca ciąg znaków po zastąpieniu jednego lub więcej dopasowań między ciągiem wejściowym a określonym wzorcem wyrażenia regularnego. Tekst zastępujący pasujący tekst jest określony w argumencie to_str. Funkcja ta działa od lewej do prawej, ale jeśli określisz ujemną wartość occurrence, funkcja będzie odczytywać od prawej do lewej.
Funkcja ta wykonuje operacje z wyrażeniami regularnymi, w których rozróżniana jest wielkość liter. Zamiast tego można użyć wariantu ReplaceRegExI(), aby wykonywać operacje z wyrażeniami regularnymi bez rozróżniania wielkości liter.
Składnia:
ReplaceRegEx (text, regex, to_str [, occurrence])
Typ zwracanych danych: ciąg znaków
Argument | Opis |
---|---|
text | Tekst ciągu wejściowego, który ma zostać zastąpiony w całości lub częściowo nowym tekstem z to_str. |
regex | Wyrażenie regularne określające, kiedy tekst ma zostać zastąpiony. Dopasowania między tym argumentem a argumentem text są zastępowane. |
to_str | Nowy tekst, który ma zastąpić istniejącą zawartość strony text. |
occurrence |
Numer dopasowania (między tekstem wejściowym a wyrażeniem regularnym) do zastąpienia nowym tekstem. Ten argument jest opcjonalny. W razie pominięcia domyślną wartością jest 0. W przypadku użycia wartości 0 lub pominięcia argumentu wszystkie dopasowania między text a regex są zastępowane przez to_str. Można określić ujemną wartość occurrence, aby wyszukiwać dopasowania od prawej do lewej. |
Przykład | Wynik |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Zwraca wartość abcxxx. W tym przykładzie cały tekst z ciągu wejściowego, który pasuje do wzorca wyrażenia regularnego, jest zastępowany nowym tekstem. |
ReplaceRegEx('abc123','[0-9]','x',1) | Zwraca wartość abcx23. Zastępowane jest tylko pierwsze wystąpienie dopasowania między ciągiem wejściowym a wzorcem wyrażenia regularnego. |
ReplaceRegEx('abc123','[0-9]','x',4) | Zwraca wartość abc123. Istnieją tylko trzy możliwe dopasowania między ciągiem wejściowym a wzorcem wyrażenia regularnego, więc nie jest wykonywana żadna modyfikacja. |
ReplaceRegEx('ABC123','[a-c]','5') | Zwraca wartość ABC123. Żadna modyfikacja nie jest wykonywana, ponieważ ReplaceRegEx() uwzględnia wielkość liter, a wariant nieuwzględniający wielkości liter nie jest używany. |
ReplaceRegExI('ABC123','[a-c]','5') | Zwraca wartość 555123. Jest używany wariant funkcji ReplaceRegExI(), który nie uwzględnia wielkości liter. |
Kiedy używać
Możesz użyć ReplaceRegEx() do modyfikacji tekstu w celu zachowania zgodności z formatowaniem i standardami, zwłaszcza gdy w danych występują złożone wzorce. Na przykład można przeformatować ciągi numerów telefonów tak, aby zawierały tylko wartości numeryczne.
W razie potrzeby można również użyć tej funkcji do maskowania poufnych informacji, takich jak dane osobowe, aby nie były one wyświetlane użytkownikom analizującym aplikację.