com.nobigsoftware.dfalex

Interface ReplacementSelector<MATCHRESULT>

public interface ReplacementSelector<MATCHRESULT>

For search and replace operations, a functional interface that is called to select replacement text for matches, based on the MATCHRESULT.

This is called by a StringSearcher.findAndReplace(String, ReplacementSelector) to replace instances of patterns found in a string.

Method Summary

Modifier and Type	Method and Description
int	apply(SafeAppendable dest, MATCHRESULT mr, java.lang.CharSequence src, int startPos, int endPos) This will be called for each instance of each pattern found

Method Detail

apply

int apply(SafeAppendable dest,
          MATCHRESULT mr,
          java.lang.CharSequence src,
          int startPos,
          int endPos)

This will be called for each instance of each pattern found

Parameters:

dest - The replacement text for the matching substring should be written here

mr - The MATCHRESULT produced by the match

src - The string being searched, or a part of the stream being searched that contains the current match

startPos - the start index of the current match in src

endPos - the end index of the current match in src

Returns:

if this is >0, then it is the position in the source string at which to continue processing after replacement. If you set this <= startPos, a runtime exception will be thrown to abort the infinite loop that would result. Almost always return 0.