Replacing a Character String (Help Editor)

Access

To find and replace a character string in the text in the active window, you must either:

Select the Replace option in the Help Editor's Edit menu.
Select the Replace option in the 4GL Editor's Edit menu.

This dialog box is used to find a character string in the active document (source or help text), starting at the cursor's current position, and replace it with another string.

If necessary, any sources in the 4GL Editor that contain blocks will be expanded in order to find any occurrences.

The search is performed in a loop: if either end of the document is reached, the search will continue in the same direction from the other end.

The search criteria will be retained for the options:

Continue search in the Help Editor's Edit menu.
Find next and Find previous in the 4GL Editor's Edit menu.

Data entry

Find what

Character string to be found.

If a block of text was selected in the active document (source or help text) when the dialog box was opened, it will appear in this field.

Default setting: the most recent search character string.

The associated button lets you select a number of common elements found in regular expressions.

Click here to display the list..

Expression	Descripion
Any character	Represents any single character (.)
Character range	Enters a range of possible characters ([]) Example: [A-Z]
Start of line	Locks the expression at the start of the line (^) Valid only at the start of an expression.
End of line	Locks the expression at the end of the line ($) Valid only at the end of an expression.
Stored subexpression	Subexpression that is stored for the Find and Replace function (())
Non-stored subexpression	Subexpression that is not stored (())
Or	Logical OR (\|) Example: num_bin_2\|num_bin_4
Zero, one or more occurrences	Repeats the expression zero, one or more times (*)
One or more occurrences	Repeats the expression at least once (+)
Quantifier	Repeats the expression in a quantified manner (x times, or from x to y times ({}) Example: {2,5} expression repeated between 2 and 5 times.
	* equivalent to {0,} + equivalent to {1,}
Space	Represents spacing characters (\s)
ID character	Represents a character that can be part of an identifier (for Adelia, except for EBCDIC characters) (\w).
Decimal digit	Represents a digit (\d). Equivalent to [0-9]

Replace with

Character string that is to replace the string entered in the Find what field.

By default, this is the last string used for the Replace function.

The associated button lets you select a number of common elements found in regular expressions.

Text found	Represents the text found during the search for a regular expression ($0).
Stored expression [1–9]	Text of the stored expression that corresponds to the selected number ($1-$9).

Note: If you are searching for a regular expression and want to include a "$" character in the replacement expression, you must double it ($$) in order to prevent the system from interpreting it as a stored expression.

Lists

Search in

List used to define the search scope.

The possible options are:

Active document	The search is performed on the current document.
All documents	The search is performed on all documents currently open in the editor.
Active block	The search is performed only on the current block (procedure, window, etc.). This option is only available if the current document is a structured source.
Selected text	The search is performed only on the current selection. The selection must be linear, i.e. it must not cover several blocks. In this search mode, only the Replace all option is available.

Check boxes

Match whole word only

Checked	Only those occurrences which exactly match the character string will be found (the search will not return parts of words).
Unchecked	All occurrences containing the character string will be found.

Match case

Checked	The search will concern the character string as it has been typed in, with exactly the same use of upper and lower case.
Unchecked	The search will not distinguish between upper and lower case characters.

Regular expression

Checked	The input string is interpreted as a regular expression.
Unchecked	The search is performed on the text in the input string.

Buttons

Replace

Used to replace the detected occurrence with the character string entered in the Replace with field and continue the search.

Replace all

Used to find all the occurrences matching the criteria specified in the dialog box and automatically replace them with the string entered in the Replace with field.

Cancel

Closes the dialog box without running the search procedure.

Keyboard shortcut: Esc.