PingOne

Regex library

You can use regular expressions in operations with the following library.

String Description Input Output

String replaceFirst(String <input>, String <regex>, String <replacement>)

where:

  • <input> is the string to search and replace in

  • <regex> is the regular expression to which this string is to be matched

  • <replacement> is the string to be substituted for the first match

Replaces the first substring of the text string that matches the given regular expression with the given replacement. A null reference passed to this method is a no-op and returns null.

  1. #regex.replaceFirst('upper case', '()( +)([a-z])', '$1_$3')

  2. #regex.replaceFirst('upper case AND lower case', '()( +)([a-z])', '$1_$3')

  1. upper_case

  2. upper_case AND lower case

String replaceAll(String <input>, String <regex1>, String <replacement1>, …​, String <regexN>, String <replacementN>)

where:

  • <input> is the string to search and replace in

  • <regex1> is the regular expression to which this string is to be matched

  • <replacement1> is the string to be substituted for each match

  • <regex[2…​N]> is an optional additional regular expression to which this string is to be matched

  • <replacement[2…​N]> is an optional additional string to be substituted for each match. If replacement is missing, the corresponding regex string won’t be altered.

The first pair of find-replace arguments are mandatory and the rest are optional.

Replaces each substring of the text string that matches the given regular expression with the given replacement. You can use this for 1 or more find and replace options. The first pair of find-replace arguments are mandatory and the rest are optional.

  1. #regex.replaceAll('upper case AND lower case', '()( +)([a-z])', '$1_$3')

  2. #regex.replaceAll('numeric data to be replaced with textual data [1, 2]', 'to be', '', '1', 'one', '2', 'two')

  1. upper_case AND lower_case

  2. numeric data replaced with textual data [one, two]

boolean matches(String <input>, String <regex>)

where:

  • <input> is the string to be matched with

  • <regex> is the regular expression to which the string is matched

Checks if the entire input string matches the regex pattern. If a null is passed as input, it returns false.

#regex.matches('upper case', '()( +)([a-z])')

true

Array findAllMatches(String <input>, String <regex>)

where:

  • <input> is the string to search in

  • <regex> is the regular expression to which the string is matched

Find all matching substrings in the input string matching the regex pattern.

#regex.findAllMatches('upper case AND lower case', '()( +)([a-z])')

["upper case", "lower case"]