ReplaceRegEx - script- en diagramfunctie
ReplaceRegEx() retourneert een tekenreeks na het vervangen van één of meer overeenkomsten tussen een invoertekenreeks en een gespecificeerd regulier expressiepatroon. De tekst die de overeenkomende tekst vervangt, wordt opgegeven in het argument to_str. De functie wordt van links naar rechts uitgevoerd, maar als u een negatieve occurrence waarde opgeeft, leest de functie van rechts naar links.
Deze functie voert regexbewerkingen uit die hoofdlettergevoelig zijn. U kunt eventueel ook de variant ReplaceRegExI() gebruiken om hoofdletteronafhankelijke regexbewerkingen uit te voeren.
Syntaxis:
ReplaceRegEx (text, regex, to_str [, occurrence])
Retourgegevenstypen: tekenreeks
Argument | Beschrijving |
---|---|
text | De tekst van de invoertekenreeks die u geheel of gedeeltelijk wilt vervangen door de nieuwe tekst van to_str. |
regex | De reguliere expressie die bepaalt wanneer tekst moet worden vervangen. Overeenkomsten tussen dit argument en het argument text worden vervangen. |
to_str | De nieuwe tekst die u wilt gebruiken om bestaande inhoud van text te vervangen. |
occurrence |
Het nummer van de overeenkomst (tussen invoertekst en reguliere expressie) om te vervangen door nieuwe tekst. Dit is een optioneel argument. De standaardwaarde is 0 als deze wordt weggelaten. Als een waarde van 0 wordt gebruikt, of als het argument wordt weggelaten, worden alle overeenkomsten tussen text en regex vervangen door to_str. U kunt een negatieve waarde opgeven voor occurrence om overeenkomsten van rechts naar links te identificeren. |
Voorbeeld | Resultaat |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Retourneert abcxxx. In dit voorbeeld wordt alle tekst uit de invoertekenreeks die overeenkomt met het regexpatroon vervangen door de nieuwe tekst. |
ReplaceRegEx('abc123','[0-9]','x',1) | Retourneert abcx23. Alleen de eerste overeenkomsten tussen de invoertekenreeks en het regexpatroon worden vervangen. |
ReplaceRegEx('abc123','[0-9]','x',4) | Retourneert abc123. Er zijn slechts drie mogelijke overeenkomsten tussen de invoertekenreeks en het regexpatroon, dus er wordt geen wijziging uitgevoerd. |
ReplaceRegEx('ABC123','[a-c]','5') | Retourneert ABC123. Er wordt geen wijziging uitgevoerd omdat ReplaceRegEx() hoofdlettergevoelig is, en de hoofdletterongevoelige variant niet wordt gebruikt. |
ReplaceRegExI('ABC123','[a-c]','5') | Retourneert 555123. De hoofdletterongevoelige variant van de functie, ReplaceRegExI(), wordt gebruikt. |
Wanneer gebruiken
U kunt ReplaceRegEx() gebruiken voor het wijzigen van tekst om te voldoen aan opmaak- en nalevingsnormen, vooral wanneer er complexe patronen in de gegevens voorkomen. U kunt bijvoorbeeld telefoonnummertekenreeksen opnieuw formatteren zodat alleen numerieke waarden worden opgenomen.
Indien nodig kunt u deze functie ook gebruiken om gevoelige informatie te maskeren, zoals persoonlijk identificeerbare informatie (PII), zodat deze niet wordt getoond aan gebruikers die uw app analyseren.