Ga naar hoofdinhoud Ga naar aanvullende inhoud

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

Argumenten
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.

Voorbeelden van functies
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.

Voorbeeld 1 - load-script om e-mailadressen van werknemers bij te werken

Voorbeeld 2 - load-script om ISBN-codes op te maken

Voorbeeld 3 - diagramuitdrukking om secundaire e-mailadressen bij te werken

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!