ReplaceRegEx - funzione dello script e del grafico
ReplaceRegEx() restituisce una stringa dopo aver sostituito una o più corrispondenze tra una stringa di input e un modello di espressione regolare specificato. Il testo che sostituisce il testo corrispondente è specificato nell'argomento to_str. La funzione viene applicata da sinistra verso destra, ma se si specifica un valore occurrence negativo, le funzioni leggono i valori da destra a sinistra.
Questa funzione esegue operazioni regex che distinguono tra maiuscole e minuscole. In alternativa, è possibile utilizzare la variante ReplaceRegExI() per eseguire operazioni regex senza distinzione tra maiuscole e minuscole.
Sintassi:
ReplaceRegEx (text, regex, to_str [, occurrence])
Tipo di dati restituiti: stringa
Argomento | Descrizione |
---|---|
text | Il testo della stringa di input che si desidera sostituire, completamente o parzialmente, con il nuovo testo di to_str. |
regex | L'espressione regolare che definisce quando sostituire il testo. Le corrispondenze tra questo argomento e l'argomento text vengono sostituite. |
to_str | Il nuovo testo che si desidera utilizzare per sostituire il contenuto esistente di text. |
occurrence |
Il numero della corrispondenza (tra il testo di input e l'espressione regolare) da sostituire con il nuovo testo. Questo argomento è facoltativo. Se viene omesso, il valore predefinito è 0. Quando viene utilizzato il valore 0 o se l'argomento viene omesso, tutte le corrispondenze tra text e regex vengono sostituite con to_str. È possibile specificare un valore negativo per occurrence se si desidera cercare le corrispondenze da destra a sinistra. |
Esempio | Risultato |
---|---|
ReplaceRegEx('abc123','[0-9]','x') | Restituisce abcxxx. In questo esempio, tutto il testo della stringa di input che corrisponde al modello regex viene sostituito con il nuovo testo. |
ReplaceRegEx('abc123','[0-9]','x',1) | Restituisce abcx23. Viene sostituita solo la prima occorrenza di una corrispondenza tra la stringa di input e il modello regex. |
ReplaceRegEx('abc123','[0-9]','x',4) | Restituisce abc123. Vi sono solo tre possibili corrispondenze tra la stringa di input e il modello regex, quindi non viene eseguita alcuna modifica. |
ReplaceRegEx('ABC123','[a-c]','5') | Restituisce ABC123. Non viene eseguita alcuna modifica perché ReplaceRegEx() fa distinzione tra maiuscole e minuscole e la variante che non le distingue non è utilizzata. |
ReplaceRegExI('ABC123','[a-c]','5') | Restituisce 555123. Viene utilizzata la variante senza distinzione tra maiuscole e minuscole della funzione, ReplaceRegExI(). |
Casi d'uso
È possibile utilizzare ReplaceRegEx() per modificare il testo per soddisfare gli standard di formattazione e di conformità, soprattutto quando esistono modelli complessi nei dati. Per esempio, è possibile riformattare le stringhe dei numeri di telefono in modo da includere solo i valori numerici.
Se necessario, è possibile anche utilizzare questa funzione per mascherare le informazioni sensibili, come le informazioni di identificazione personale (PII), in modo che non vengano mostrate agli utenti che analizzano l'app.