findandReplace (NotesRichTextRange - JavaScript™)

Replaces the next occurrence of a string in a rich text range, and moves the current position to the beginning of the first occurrence of the string.

Defined in

NotesRichTextRange

Syntax

findandReplace(target:string, replacement:string) : int

findandReplace(target:string, replacement:string, options:long) : int

Parameter	Description
String target	The search string.
String replacement	The replacement string.
long options	Any of the following search options. Specify multiple options by combining them with addition or logical ORs. RichTextItem.RT_FIND_ACCENTINSENSITIVE for accent insensitive search (default is accent sensitive) RichTextItem.RT_FIND_CASEINSENSITIVE for case insensitive search (default is case sensitive) RichTextItem.RT_FIND_PITCHINSENSITIVE for pitch insensitive search (default is pitch sensitive) RichTextItem.RT_REPL_ALL to replace all occurrences of the search string RichTextItem.RT_REPL_PRESERVECASE to preserve case in the replacement string

Return value	Description
int	The number of replacements made.

Usage

For purposes of navigation, this method finds an element of type RTELEM_TYPE_TEXTRUN. The current position becomes the first character of the search string within the element (not the first character of the element).

The range is reset after a findAndReplace operation.