| (2 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
The replace dialog allows you to search for a specific text string and replace it with a different text string. | The replace dialog allows you to search for a specific text string and replace it with a different text string. | ||
| − | Enter the string to search for in the '''Find what''' field, and the replace string to be used in the ''Replace with''' field. Both of these fields support single or multi-line strings up to 20,000 bytes. | + | Enter the string to search for in the '''Find what''' field, and the replace string to be used in the '''Replace with''' field. Both of these fields support single or multi-line strings up to 20,000 bytes. |
| − | If the string is not found, the search wraps around to the other end of the file and continues the search. To configure this behavior, see the [[Search:Miscellaneous|Search » Miscellaneous help topic | + | If the string is not found, the search wraps around to the other end of the file and continues the search. To configure this behavior, see the [[Settings:Search:Miscellaneous|Settings » Search » Miscellaneous]] help topic. |
If the string doesn't exist in the file, UltraEdit will prompt you. | If the string doesn't exist in the file, UltraEdit will prompt you. | ||
| Line 37: | Line 37: | ||
'''Next'''<br> | '''Next'''<br> | ||
| − | (Note: This button will be labeled "Start" if ''Show slim dialog after start'' is not enabled in Settings under [[Search:Miscellaneous|Search » Miscellaneous]] - by default, it is not.) Clicking the '''Next''' button initiates a search for the string in the '''Find What''' field. If the string is not found from the caret position to the end of the file, then the search wraps around to the top of the file and continues the search with a brief notification displayed at the lower-right of the editor window. To configure this behavior, see the [[Search:Miscellaneous|Search » Miscellaneous]] help topic. | + | (Note: This button will be labeled "Start" if ''Show slim dialog after start'' is not enabled in Settings under [[Settings:Search:Miscellaneous|Settings » Search » Miscellaneous]] - by default, it is not.) Clicking the '''Next''' button initiates a search for the string in the '''Find What''' field. If the string is not found from the caret position to the end of the file, then the search wraps around to the top of the file and continues the search with a brief notification displayed at the lower-right of the editor window. To configure this behavior, see the [[Settings:Search:Miscellaneous|Settings » Search » Miscellaneous]] help topic. |
If the string doesn't exist in the file, UltraEdit will prompt you. | If the string doesn't exist in the file, UltraEdit will prompt you. | ||
| − | If ''Show slim dialog after start'' '''is''' enabled in Settings under [[Search:Miscellaneous|Search » Miscellaneous]] (by default, it is not), then UltraEdit will highlight the first match and open the slim replace dialog. Otherwise, the Replace dialog will remain open. | + | If ''Show slim dialog after start'' '''is''' enabled in Settings under [[Settings:Search:Miscellaneous|Settings » Search » Miscellaneous]] (by default, it is not), then UltraEdit will highlight the first match and open the slim replace dialog. Otherwise, the Replace dialog will remain open. |
Once UltraEdit highlights a match, the Replace (or slim replace) dialog offers the following options: | Once UltraEdit highlights a match, the Replace (or slim replace) dialog offers the following options: | ||
| Line 63: | Line 63: | ||
You can set the search area to '''Current file''', '''Selected text''' or '''All open files''' here. If you select '''All open files''', pressing '''Next''' will automatically move focus to the first match in the next open file. | You can set the search area to '''Current file''', '''Selected text''' or '''All open files''' here. If you select '''All open files''', pressing '''Next''' will automatically move focus to the first match in the next open file. | ||
| − | Note: If ''Set 'Find/Replace where' to 'Selected text' if more than one line selected'' is enabled in Settings under [[Search:Auto reset settings|Search » Auto reset settings]] (it is, by default), then the '''In''' setting will automatically be set to '''Selected text''' if the selection contains more than one line and at least one non-whitespace character. | + | Note: If ''Set 'Find/Replace where' to 'Selected text' if more than one line selected'' is enabled in Settings under [[Settings:Search:Auto reset settings|Settings » Search » Auto reset settings]](it is, by default), then the '''In''' setting will automatically be set to '''Selected text''' if the selection contains more than one line and at least one non-whitespace character. |
[[File:Ultraedit find i options.png|left]] '''Advanced options button'''<br> | [[File:Ultraedit find i options.png|left]] '''Advanced options button'''<br> | ||
| Line 73: | Line 73: | ||
'''Match case'''<br> | '''Match case'''<br> | ||
| − | This option forces the search to match the case of the '''Find what'' string | + | This option forces the search to match the case of the '''Find what'' string exactl.y This option applies to regular expressions as well. |
'''Regular expressions'''<br> | '''Regular expressions'''<br> | ||
The replace dialog allows you to search for a specific text string and replace it with a different text string.
Enter the string to search for in the Find what field, and the replace string to be used in the Replace with field. Both of these fields support single or multi-line strings up to 20,000 bytes.
If the string is not found, the search wraps around to the other end of the file and continues the search. To configure this behavior, see the Settings » Search » Miscellaneous help topic.
If the string doesn't exist in the file, UltraEdit will prompt you.
In addition to regular characters and strings, both the Find what and Replace with fields support searching for several special characters and strings with special notation. For example, "^t" will match a tab (or insert a tab if part of the Replace with string). For a complete list of these values, see Special search characters. These special characters are valuable for matching non-printable text in files.
History button
This button displays a scrollable history list for either Find what or Replace with.
Favorites button
This button opens the Find what or Replace with favorites menu with the following options:
| Add to Favorites | adds current item in "Find what" field to Favorites list |
| Edit Favorites | opens Edit Find/Replace Favorites dialog where you can name favorite search strings, organize the list and remove items from the list |
| Favorites | opens sub-menu to select an existing favorite for the "Find what" string |
Regular expressions help button
This button opens a short regular expression syntax reference for the selected regular expression engine. This button is subdued unless the regular expressions checkbox is checked.
Swap button
This button swaps the contents of the Find what and Replace with fields.
Next
(Note: This button will be labeled "Start" if Show slim dialog after start is not enabled in Settings under Settings » Search » Miscellaneous - by default, it is not.) Clicking the Next button initiates a search for the string in the Find What field. If the string is not found from the caret position to the end of the file, then the search wraps around to the top of the file and continues the search with a brief notification displayed at the lower-right of the editor window. To configure this behavior, see the Settings » Search » Miscellaneous help topic.
If the string doesn't exist in the file, UltraEdit will prompt you.
If Show slim dialog after start is enabled in Settings under Settings » Search » Miscellaneous (by default, it is not), then UltraEdit will highlight the first match and open the slim replace dialog. Otherwise, the Replace dialog will remain open.
Once UltraEdit highlights a match, the Replace (or slim replace) dialog offers the following options:
Find next
Moves to the next match of the Find what string without making a replacement.
Replace
Replaces the currently selected match and moves to the next match.
Replace all
Replaces all matches in the file.
Last (slim replace dialog only)
Replaces the currently selected match and closes the slim replace dialog.
Close
Closes the slim replace dialog
In
You can set the search area to Current file, Selected text or All open files here. If you select All open files, pressing Next will automatically move focus to the first match in the next open file.
Note: If Set 'Find/Replace where' to 'Selected text' if more than one line selected is enabled in Settings under Settings » Search » Auto reset settings(it is, by default), then the In setting will automatically be set to Selected text if the selection contains more than one line and at least one non-whitespace character.
Advanced options button
This button expands the advanced search options which are covered below.
Match whole word
This option forces the search to match whole words only. This is useful, for example, if you only want to replace 'a', or 'A' without replacing 'a' that occurs as part of a larger word.
Match case
This option forces the search to match the case of the 'Find what string exactl.y This option applies to regular expressions as well.
Regular expressions
This option enables the use of regular expressions for both the Find what and Replace with strings. There are 3 different types of regular expressions available:
For information regarding creation of regular expressions see the Regular expressions or Perl regular expressions topic.
Preserve case
This options forces the search to match the case of the Replace with string with the case of the matched string. The rules for this are as follows:
For example, with this option selected, and Find what set to "The" and Replace with set to "Then":
The mixed case scenario requires the Replace with string to have the same number of uppercase characters as its match so that UltraEdit knows where the (matching) mixed case letters are. For example, a replace consisting of "SomeString" for Find what and "FooBar" for Replace with would result in the following matches / replacements:
Replace all is from top of file
If checked, the replace will always run from the top of the active file rather than the caret position.
Close after replace all
This option closes the Replace dialog after a successful Replace all in which there was at least 1 replacement.
In column
This option restricts the replace to the user-specified start and end columns. The number entered for the end column must be greater than the number entered for the start column (except when searching an entire line). To search an entire line, use "0" and "-1". Note that column numbering begins with "0" so the initial column value would have to be set to "0" to search from the beginning of a line.
UltraEdit Wiki