org.eclipse.jface.text
Interface IFindReplaceTargetExtension3

public interface IFindReplaceTargetExtension3

Extension interface for IFindReplaceTarget. Extends the find replace target's findAndSelect method to allow regular expression find/replace.

Since:

3.0

Method Summary

int	findAndSelect(int offset, String findString, boolean searchForward, boolean caseSensitive, boolean wholeWord, boolean regExSearch) Searches for a string starting at the given offset and using the specified search directives.
void	replaceSelection(String text, boolean regExReplace) Replaces the currently selected range of characters with the given text.

Method Detail

findAndSelect

public int findAndSelect(int offset,
                         String findString,
                         boolean searchForward,
                         boolean caseSensitive,
                         boolean wholeWord,
                         boolean regExSearch)

Searches for a string starting at the given offset and using the specified search directives. If a string has been found it is selected and its start offset is returned. If regExSearch is true the findString is interpreted as a regular expression for searching.

Parameters:

offset - the offset at which searching starts

findString - the string which should be found

searchForward - true searches forward, false backwards

caseSensitive - true performes a case sensitve search, false an insensitive search

wholeWord - if true only occurences are reported in which the findString stands as a word by itself. Must not be used in combination with regExSearch.

regExSearch - if true findString represents a regular expression Must not be used in combination with wholeWord.

Returns:

the position of the specified string, or -1 if the string has not been found

Throws:

PatternSyntaxException - if regExSearch is true and findString is an invalid regular expression

replaceSelection

public void replaceSelection(String text,
                             boolean regExReplace)

Replaces the currently selected range of characters with the given text. If regExReplace is true the text is interpreted as a regular expression for searching. This target must be editable. Otherwise nothing happens.

Parameters:

text - the substitution text

regExReplace - if true text represents a regular expression

Throws:

IllegalStateException - if a REPLACE or REPLACE_FIND operation is not preceded by a successful FIND operation

PatternSyntaxException - if regExReplace is true and text is an invalid regular expression