Search and Replace - Revision history

Jsimlo at 22:21, 10 October 2021

2021-10-10T22:21:40Z

Jsimlo at 23:44, 27 August 2019

2019-08-27T23:44:13Z

Jsimlo at 20:37, 11 June 2016

2016-06-11T20:37:46Z

Jsimlo: /* Hotkeys */

2013-10-01T21:49:55Z

Hotkeys

Jsimlo: /* Hotkeys */

2013-10-01T21:48:45Z

Hotkeys

Jsimlo: /* Hotkeys */

2013-10-01T14:02:57Z

Hotkeys

Jsimlo: 6.0.0.17

2012-03-16T18:54:12Z

6.0.0.17

New page

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Search menu|Replace.. (Ctrl+R) (Ctrl+H)}}

Shows the {{dialog|Search and Replace}} dialog at the bottom of the window, which is an extension to the {{dialog|Search}} dialog, also called the {{dialog|Search bar}}.
After entering search and replace conditions, searches for specified {{field|Search|Find}} phrase within the document and replaces found occurrence with {{field|Replace|Replace}} phrase.

Note: See {{dialog|Search}} dialog for description and information about available search conditions and options inherited here from {{dialog|Search}} dialog. Following are only options exclusive to the {{dialog|Replace}} dialog part.

{{field|Replace|Mimic case}} option can be used to modify {{defined|character case}} of the replacement upon replacing an occurrence. For each occurrence, the actual {{defined|character case}} of the match is examined, and then the respective replacement string is converted to imitate (mimic) such case. It is important to understand that each match and its replacement is examined and converted independently. It means that the original {{field|Replace|Replace}} phrase is never modified in this process, but it also means that (with regular expressions) back-references may also get converted based on respective matches.

{{button|Replace|Replace}} button first verifies that the current selection matches the given search conditions, then either replaces it with {{field|Replace|Replace}} phrase, or if current selection does not match the search, searches for the next occurrence instead of replacing. This behaviour ensures that only matching pieces ever get replaced. After successful replacement, automatically searches for any next occurrence.

{{button|Replace|Replace All}} button starts searching at the beginning of the document and replaces every match found throughout the entire document. Note: Since searching and replacing throughout the entire document can take a very long time, {{hotkey|Esc}} can be used to interrupt the process at any time.

{{tip}} To {{button|Replace|Replace All}} in documents where too many occurrences are expected, or to {{button|Replace|Replace All}} within selection only, use much faster and selection-oriented {{feature|Extended Replace}} tool (hotkey {{hotkey|Alt+Ctrl+R}}). See chapter [[Text tools]]. There are also other advantages in {{feature|Extended Replace}} tool over the more classic {{button|Replace|Replace All}} command, e.g. the {{feature|Extended Replace}} tool offers much bigger dialog fields for entering search and replace phrases.

Note: Works with the {{feature|primary search}} definition, unless {{field|Search|Use 2nd search}} option specifies otherwise.

{{tip}} If you need to replace individual characters for other characters, for examle, to get rid of encoding or punctuation, use the {{feature|Translate Characters}} tool instead (hotkey {{hotkey|Alt+Ctrl+T}}). See chapter [[Text tools]].

=====Hotkeys=====

Following hotkeys are available in both {{dialog|Search}} dialog and {{dialog|Search and Replace}} dialog (well, they both kinda look the same, don't they :), however, some of them work only if controls of the {{dialog|Replace}} dialog part are focused, e.g. {{field|Replace|Replace}} editbox or {{field|Replace|Mimic case}} option.

Using {{feature|primary search}} or {{feature|secondary search}} corresponding to option {{field|Search|Use 2nd search}}:
* {{hotkey|Enter}} — Search and Replace downwards. ({{dialog|Replace}} dialog part only)
* {{hotkey|Ctrl+Enter}} — Search and Replace upwards. ({{dialog|Replace}} dialog part only)
* {{hotkey|Shift+Enter}} — Search downwards from the beginning of the document.
* {{hotkey|Ctrl+Shift+Enter}} — Search upwards from the end of the document.

Using {{feature|primary search}} directly:
* {{hotkey|F3}} — Search downwards.
* {{hotkey|Ctrl+F3}} — Search upwards.
* {{hotkey|Shift+F3}} — Search downwards, select text along.
* {{hotkey|Ctrl+Shift+F3}} — Search upwards, select text along.

Using {{feature|secondary search}} directly:
* {{hotkey|F2}} — Search downwards.
* {{hotkey|Ctrl+F2}} — Search upwards.
* {{hotkey|Shift+F2}} — Search downwards, select text along.
* {{hotkey|Ctrl+Shift+F2}} — Search upwards, select text along.

{{todo|the list of all hotkeys}}

← Older revision		Revision as of 22:21, 10 October 2021
Line 20:		Line 20:

	{{tip}} If you need to replace individual characters for other characters, for examle, to get rid of encoding or punctuation, use the {{feature\|Translate Characters}} tool instead (hotkey {{hotkey\|Alt+Ctrl+T}}). See chapter [[Text tools]].		{{tip}} If you need to replace individual characters for other characters, for examle, to get rid of encoding or punctuation, use the {{feature\|Translate Characters}} tool instead (hotkey {{hotkey\|Alt+Ctrl+T}}). See chapter [[Text tools]].
		+
		+	Note: {{button\|Replace\|Replace All}} posts <q>Total matches</q> to the {{feature\|Status Bar}}.

	=====Search bar hotkeys=====		=====Search bar hotkeys=====

← Older revision		Revision as of 23:44, 27 August 2019
Line 12:		Line 12:

	{{button\|Replace\|Replace All}} button starts searching at the beginning of the document and replaces every match found throughout the entire document. Note: Since searching and replacing throughout the entire document can take a very long time, {{hotkey\|Esc}} can be used to interrupt the process at any time.		{{button\|Replace\|Replace All}} button starts searching at the beginning of the document and replaces every match found throughout the entire document. Note: Since searching and replacing throughout the entire document can take a very long time, {{hotkey\|Esc}} can be used to interrupt the process at any time.
		+
		+	{{tip}} Number of replacements appears in the {{feature\|Status Bar}} after each {{button\|Replace\|Replace All}}.

	{{tip}} To {{button\|Replace\|Replace All}} in documents where too many occurrences are expected, or to {{button\|Replace\|Replace All}} within selection only, use much faster and selection-oriented {{feature\|Extended Replace}} tool (hotkey {{hotkey\|Alt+Ctrl+R}}). See chapter [[Text tools]]. There are also other advantages in {{feature\|Extended Replace}} tool over the more classic {{button\|Replace\|Replace All}} command, e.g. the {{feature\|Extended Replace}} tool offers much bigger dialog fields for entering search and replace phrases.		{{tip}} To {{button\|Replace\|Replace All}} in documents where too many occurrences are expected, or to {{button\|Replace\|Replace All}} within selection only, use much faster and selection-oriented {{feature\|Extended Replace}} tool (hotkey {{hotkey\|Alt+Ctrl+R}}). See chapter [[Text tools]]. There are also other advantages in {{feature\|Extended Replace}} tool over the more classic {{button\|Replace\|Replace All}} command, e.g. the {{feature\|Extended Replace}} tool offers much bigger dialog fields for entering search and replace phrases.

@@ Line 19: / Line 19: @@
 {{tip}} If you need to replace individual characters for other characters, for examle, to get rid of encoding or punctuation, use the {{feature|Translate Characters}} tool instead (hotkey {{hotkey|Alt+Ctrl+T}}). See chapter [[Text tools]].
-=====Hotkeys=====
+=====Search bar hotkeys=====
 Following hotkeys are available in both {{dialog|Search}} dialog and {{dialog|Search and Replace}} dialog <small>(well, they both kinda look the same, don't they :)</small>, however, some of them work only if controls of the {{dialog|Replace}} dialog part are focused, e.g. {{field|Replace|Replace}} editbox or {{field|Replace|Mimic case}} option.

← Older revision		Revision as of 21:48, 1 October 2013
Line 40:		Line 40:
	* {{hotkey\|Shift+F2}} — Search downwards, select text along.		* {{hotkey\|Shift+F2}} — Search downwards, select text along.
	* {{hotkey\|Ctrl+Shift+F2}} — Search upwards, select text along.		* {{hotkey\|Ctrl+Shift+F2}} — Search upwards, select text along.
−
−	~~{{todo\|the list of all hotkeys}}~~

@@ Line 23: / Line 23: @@
 Following hotkeys are available in both {{dialog|Search}} dialog and {{dialog|Search and Replace}} dialog <small>(well, they both kinda look the same, don't they :)</small>, however, some of them work only if controls of the {{dialog|Replace}} dialog part are focused, e.g. {{field|Replace|Replace}} editbox or {{field|Replace|Mimic case}} option.
-Using {{feature|primary search}} or {{feature|secondary search}} corresponding to option {{field|Search|Use 2nd search}}:
+Using {{feature|primary search}} or {{feature|secondary search}} correspondingly to option {{field|Search|Use 2nd search}}:
 * {{hotkey|Enter}} &mdash; Search and Replace downwards. <small>({{dialog|Replace}} dialog part only)</small>
 * {{hotkey|Ctrl+Enter}} &mdash; Search and Replace upwards. <small>({{dialog|Replace}} dialog part only)</small>
@@ Line 29: / Line 29: @@
 * {{hotkey|Ctrl+Shift+Enter}} &mdash; Search upwards from the end of the document.
-Using {{feature|primary search}} directly:
+Using {{feature|primary search}} directly. Note: All these hotkeys automatically turn the {{field|Search|Use 2nd search}} option off:
 * {{hotkey|F3}} &mdash; Search downwards.
 * {{hotkey|Ctrl+F3}} &mdash; Search upwards.
@@ Line 35: / Line 35: @@
 * {{hotkey|Ctrl+Shift+F3}} &mdash; Search upwards, select text along.
-Using {{feature|secondary search}} directly:
+Using {{feature|secondary search}} directly. Note: All these hotkeys automatically turn the {{field|Search|Use 2nd search}} option on:
 * {{hotkey|F2}} &mdash; Search downwards.
 * {{hotkey|Ctrl+F2}} &mdash; Search upwards.

@@ Line 7: / Line 7: @@
 Note: See {{dialog|Search}} dialog for description and information about available search conditions and options inherited here from {{dialog|Search}} dialog. Following are only options exclusive to the {{dialog|Replace}} dialog part.
-{{field|Replace|Mimic case}} option can be used to modify {{defined|character case}} of the replacement upon replacing an occurrence. For each occurrence, the actual {{defined|character case}} of the match is examined, and then the respective replacement string is converted to imitate (mimic) such case. It is important to understand that each match and its replacement is examined and converted independently. It means that the original {{field|Replace|Replace}} phrase is never modified in this process, but it also means that (with regular expressions) back-references may also get converted based on respective matches.
+{{field|Replace|Mimic case}} option can be used to modify {{defined|character case}} of the replacement upon replacing an occurrence. For each occurrence, the actual {{defined|character case}} of the match is examined, and then the respective replacement string is converted to imitate (mimic) such case. It is important to understand that each match and its replacement is examined and converted independently. It means that the original {{field|Replace|Replace}} phrase is never modified in this process, but it also means that (with [[regular expressions]]) back-references may also get converted based on respective matches.
 {{button|Replace|Replace}} button first verifies that the current selection matches the given search conditions, then either replaces it with {{field|Replace|Replace}} phrase, or if current selection does not match the search, searches for the next occurrence instead of replacing. This behaviour ensures that only matching pieces ever get replaced. After successful replacement, automatically searches for any next occurrence.