ReplaceRegEx - skript- och diagramfunktion
ReplaceRegEx() returnerar en sträng efter att ha ersatt en eller flera matchningar mellan en indatasträng och ett angivet reguljärt uttrycksmönster. Den text som ersätter den matchande texten anges i argumentet to_str. Funktionen går från vänster till höger, men om du anger ett negativt värde för occurrence läses funktionen från höger till vänster.
Den här funktionen utför regexoperationer som är skiftlägeskänsliga. Alternativt kan du använda varianten ReplaceRegExI() för att utföra skiftlägesokänsliga regexoperationer.
Syntax:
ReplaceRegEx (text, regex, to_str [, occurrence])
Returnerad datatyp: sträng
Argument | Beskrivning |
---|---|
text | Den text i indatasträngen som du vill ersätta, helt eller delvis, med den nya texten från to_str. |
regex | Det reguljära uttryck som definierar när text ska ersättas. Matchningar mellan detta argument och text-argumentet ersätts. |
to_str | Den nya texten som du vill använda för att ersätta befintligt innehåll från text. |
occurrence |
Numret på matchningen (mellan inmatad text och reguljärt uttryck) som ska ersättas med ny text. Det här är ett valfritt argument. Standardvärdet är 0 om det utelämnas. När värdet 0 används, eller om argumentet utelämnas, ersätts alla matchningar mellan text och regex med to_str. Du kan ange ett negativt värde för occurrence för att hitta matchningar från höger till vänster. |
Exempel | Resultat |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Returnerar abcxxx. I det här exemplet ersätts all text från indatasträngen som matchar regexmönstret med den nya texten. |
ReplaceRegEx('abc123','[0-9]','x',1) | Returnerar abcx23. Endast den första förekomsten av en matchning mellan indatasträngen och regexmönstret ersätts. |
ReplaceRegEx('abc123','[0-9]','x',4) | Returnerar abc123. Det finns bara tre möjliga matchningar mellan indatasträngen och regexmönstret, så ingen ändring utförs. |
ReplaceRegEx('ABC123','[a-c]','5') | Returnerar ABC123. Ingen ändring görs eftersom ReplaceRegEx() är skiftlägeskänsligt och den skiftlägesokänsliga varianten inte används. |
ReplaceRegExI('ABC123','[a-c]','5') | Returnerar 555123. Den skiftlägesokänsliga varianten av funktionen, ReplaceRegExI(), används. |
Användning
Du kan använda ReplaceRegEx() för att ändra text så att den uppfyller formaterings- och efterlevnadsstandarder, särskilt när det finns komplexa mönster i dina data. Du kan t.ex. formatera om telefonnummersträngar så att endast numeriska värden inkluderas.
Vid behov kan du också använda den här funktionen för att maskera känslig information, t.ex. personliga identitetsuppgifter (PII), så att den inte visas för användare som analyserar din app.