Package com.intellij.find.impl

Class RegExReplacementBuilder

java.lang.Object

com.intellij.find.impl.RegExReplacementBuilder

public class RegExReplacementBuilder
extends java.lang.Object

Generates a replacement string for search/replace operation using regular expressions.

The logic is based on java.util.regex.Matcher.appendReplacement method, special characters (\n, \r, \t, \f, \b, \xNNNN) and case conversion characters (\l, \u, \L, \U, \E) are additionally supported.

Instances of this class are not safe for use by multiple concurrent threads, just as Matcher instances are.

Constructor Summary

Constructors

Constructor and Description
RegExReplacementBuilder(java.util.regex.Matcher matcher)

Method Summary

Modifier and Type	Method and Description
java.lang.String	createReplacement(java.lang.String template) Generates a replacement string from provided template value, substituting referenced capturing group values, and processing supported special and control characters.
static void	validate(java.util.regex.Pattern pattern, java.lang.String template) Validates the replacement template.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RegExReplacementBuilder

public RegExReplacementBuilder(java.util.regex.Matcher matcher)

Method Detail

validate

public static void validate(java.util.regex.Pattern pattern,
                            java.lang.String template)
                     throws java.lang.IllegalArgumentException

Validates the replacement template. This doesn't check currently whether group names actually exist.

Parameters:

pattern - current pattern

template - replacement template

Throws:

java.lang.IllegalArgumentException - if template is malformed

createReplacement

public java.lang.String createReplacement(java.lang.String template)

Generates a replacement string from provided template value, substituting referenced capturing group values, and processing supported special and control characters.

Matcher used to create this instance of RegExReplacementBuilder is supposed to be in a state created by a successful find() or find(int) invocation.