Ga naar hoofdinhoud Ga naar aanvullende inhoud

ReplaceRegExGroup - script- en diagramfunctie

ReplaceRegExGroup() retourneert een tekenreeks na het vervangen van één of meer overeenkomsten tussen een invoertekenreeks en het samengestelde reguliere expressiepatroon dat is opgegeven. 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 ReplaceRegExGroupI() gebruiken om hoofdletteronafhankelijke regexbewerkingen uit te voeren.

Syntaxis:  

ReplaceRegExGroup (text, regex, to_str, group [, 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.
group

Het nummer van de groep, in het geval van een samengestelde reguliere expressie.

Als de reguliere expressie slechts één groep bevat, gebruik dan in plaats daarvan de functie ReplaceRegEx(). Als alternatief kunt u ReplaceRegExGroup() gebruiken met een group waarde van 0.

U kunt een negatieve group waarde opgeven om van rechts naar links naar groepen te zoeken.

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
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',0) Retourneert abx (volledige overeenkomst vervangen).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',1) Retourneert abx123 (vervang alleen de eerste groep in de overeenkomst).
ReplaceRegExGroup('abc123','([a-z])([0-9]+)','x',2) Retourneert abcx (vervang alleen de tweede groep in de overeenkomst).
ReplaceRegExGroup('abc123abc123','([a-z])([0-9]+)','x',1,2) Retourneert abc123abx123. Er zijn twee overeenkomsten tussen de eerste groep van de invoertekst en het regexpatroon. Alleen het tweede exemplaar wordt echter vervangen.
ReplaceRegExGroup('ABC123ABC123','([a-z])([0-9]+)','x',1) Retourneert ABC123ABC123. Met andere woorden, er wordt geen tekst vervangen. Dit komt doordat de functie hoofdlettergevoelig is en de hoofdletterongevoelige variant van de functie niet wordt gebruikt.
ReplaceRegExGroupI('ABC123ABC123','([a-z])([0-9]+)','x',1) Retourneert ABx123ABx123. In dit voorbeeld wordt tekst vervangen omdat de hoofdletterongevoelige variant van de functie, ReplaceRegExGroupI(), wordt gebruikt.

Wanneer gebruiken

U kunt ReplaceRegExGroup() gebruiken voor het wijzigen van tekst om te voldoen aan opmaak- en nalevingsnormen, vooral wanneer u complexe patronen in de gegevens wilt identificeren. Met het extra argument group voor deze functie kunt u alleen bepaalde delen van een groter tekstpatroon bijwerken. U kunt bijvoorbeeld specifieke delen van een URL bijwerken.

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 domein in URL's bij te werken

Voorbeeld 2 - diagramuitdrukking om protocol in URL's 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!