Interface RegularExpression

All Known Implementing Classes:
ARegularExpression, JavaRegularExpression

public interface RegularExpression
This interface represents a compiled regular expression. There are different implementations for different regex engines
  • Method Details

    • matches

      boolean matches(CharSequence input)
      Determine whether the regular expression matches a given string in its entirety
      Parameters:
      input - the string to match
      Returns:
      true if the string matches, false otherwise
    • containsMatch

      boolean containsMatch(CharSequence input)
      Determine whether the regular expression contains a match of a given string
      Parameters:
      input - the string to match
      Returns:
      true if the string matches, false otherwise
    • tokenize

      AtomicIterator tokenize(CharSequence input)
      Use this regular expression to tokenize an input string.
      Parameters:
      input - the string to be tokenized
      Returns:
      a SequenceIterator containing the resulting tokens, as objects of type StringValue
    • analyze

      RegexIterator analyze(CharSequence input)
      Use this regular expression to analyze an input string, in support of the XSLT analyze-string instruction. The resulting RegexIterator provides both the matching and non-matching substrings, and allows them to be distinguished. It also provides access to matched subgroups.
      Parameters:
      input - the character string to be analyzed using the regular expression
      Returns:
      an iterator over matched and unmatched substrings
    • replace

      CharSequence replace(CharSequence input, CharSequence replacement) throws XPathException
      Replace all substrings of a supplied input string that match the regular expression with a replacement string.
      Parameters:
      input - the input string on which replacements are to be performed
      replacement - the replacement string in the format of the XPath replace() function
      Returns:
      the result of performing the replacement
      Throws:
      XPathException - if the replacement string is invalid
    • replaceWith

      CharSequence replaceWith(CharSequence input, Function<CharSequence,CharSequence> replacement) throws XPathException
      Replace all substrings of a supplied input string that match the regular expression with a replacement string.
      Parameters:
      input - the input string on which replacements are to be performed
      replacement - a function that is called once for each matching substring, and that returns a replacement for that substring
      Returns:
      the result of performing the replacement
      Throws:
      XPathException - if the replacement string is invalid
    • getFlags

      String getFlags()
      Get the flags used at the time the regular expression was compiled.
      Returns:
      a string containing the flags