Related Pages:
Related Documentation:
Syntax | set changed = aString.replace(regExpPattern, replacement) set changed = replace(LITERAL, regExpPattern, replacement) | |
---|---|---|
Semantics | All strings that correspond to the regular expression pattern will be replaced with the string replacement . If the pattern does not match, the unchanged string will be returned. Returns a new string. The state of the current string is not changed. | |
Substitutables | aString
| Can be any variable or object attribute having type String. |
replacement | Can be any variable or object attribute having type String. | |
regExpPattern | Regular expression (see Regular Expressions for a list of valid regular expressions). An introduction into regular expressions can be found at regular-expressions.info. | |
LITERAL | String literal. | |
Error Codes | Find the related error codes on System Errors. | |
FUSSM/11 | Cannot execute replace operations on empty strings. | |
FUSSM/12 | Cannot construct replace matcher finding occurrences of <string> in <string>. | |
FUSSM/13 | Cannot execute replace operations using an empty replace string. | |
FUSSM/14 | Cannot compile the regular expression <string> in replace(). Error on line <number>, column <number>. | |
FUSSM/15 | Cannot construct replace matcher finding occurrences of <string> in <string>. | |
FUSSM/16 | Cannot replace all occurences of <string> in string <string> by <string>. | |
Examples | set changed = stringSet.s1.replace("X.+", "A"); |
Trimming spaces and whitespaces
If you want to trim leading or trailing spaces or whitespaces of a string, you can use regular expressions in order to remove them.
Trimming leading spaces | set trimmedString = stringSet.s1.replace("^[ ]+", ""); |
Trimming trailing spaces | set trimmedString = stringSet.s1.replace("[ ]+$", ""); |
Trimming leading and trailing spaces | set trimmedString = stringSet.s1.replace("^[ ]+|[ ]+$", ""); |
Trimming leading spaces and whitespaces (\t) | set trimmedString = stringSet.s1.replace("^[ \t]+", ""); |
Overview
Content Tools