Extended Replace - Revision history

Jsimlo at 22:16, 10 October 2021

2021-10-10T22:16:19Z

Jsimlo at 22:47, 5 October 2021

2021-10-05T22:47:58Z

Jsimlo at 23:00, 20 November 2013

2013-11-20T23:00:29Z

Jsimlo at 11:34, 19 November 2013

2013-11-19T11:34:09Z

Jsimlo at 15:27, 6 November 2011

2011-11-06T15:27:29Z

Kew at 07:50, 29 June 2011

2011-06-29T07:50:27Z

Jsimlo at 18:53, 21 June 2011

2011-06-21T18:53:15Z

Jsimlo at 20:56, 7 May 2011

2011-05-07T20:56:09Z

Jsimlo at 20:48, 7 May 2011

2011-05-07T20:48:14Z

Jsimlo: Created page with '{{manversion|5.3.0.2|feature}}NOTOC ====Extended Replace.. (Alt+Ctrl+R)==== Searches for all occurrences of a specified {{field|Extended Replace|Find …'

2011-05-02T16:09:51Z

Created page with '<noinclude>{{manversion|5.3.0.2|feature}}__NOTOC__</noinclude> ====Extended Replace.. (Alt+Ctrl+R)==== Searches for all occurrences of a specified {{field|Extended Replace|Find …'

New page

<noinclude>{{manversion|5.3.0.2|feature}}__NOTOC__</noinclude>
====Extended Replace.. (Alt+Ctrl+R)====

Searches for all occurrences of a specified {{field|Extended Replace|Find what}} phrase within the selection and replaces them with {{field|Extended Replace|Replace with}} phrase.

Use {{field|Extended Replace|Match case}} option to make the search {{defined|case-sensitive}}.

Use {{field|Extended Replace|Whole words}} option to restrict the search to only those matches, which start and end at word boundaries. Note that the match itself might contain {{defined|non-word characters}}, since only the boundaries of a match are checked. Therefore, the last character before the match and the first character after the match may not be {{defined|word characters}}; while the first character and the last character of the match must be {{defined|word characters}}.

Use {{field|Extended Replace|RegExps}} option to #########################

Use {{field|Extended Replace|Mimic case}} option to #########################

Note: Newlines and Tab characters can be used in {{field|Extended Replace|Find what}} and {{field|Extended Replace|Replace with}} fields freely. Moreover, each newline from the {{field|Extended Replace|Find what}} field matches any kind newline in the document (Win/Unix/Mac), and each newline from the {{field|Extended Replace|Replace with}} field is converted to the current newline type (as shown in the {{feature|Status Bar}} for example) upon replacing.

Note: This tool is prefered to the standard {{button|Find Bar|Replace All}} mechanism from the {{feature|Find Bar}} in many cases. Its search is done in more feasible way and the replacing routine works much more faster and uses much less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature|Undo}} step instead of too many small {{feature|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button|Find Bar|Replace All}} routine might come more handy.

@@ Line 10: / Line 10: @@
 {{field|Extended Replace|RegExps}} option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Extended Replace|Find what}} is parsed as a ''regular expression pattern'' and {{field|Extended Replace|Replace with}} is parsed as a ''replace pattern''. See chapters [[Regular expressions]] and [[Regular expressions#Replace patterns|Replace patterns]] for more details on supported regular expressions syntax and replace pattern syntax.
-Note: Invalid or faulty patterns result in tool refusing to work until the pattern is corrected.
+Note: Invalid or faulty regular expression patterns result in tool refusing to work until the pattern is corrected.
 {{field|Extended Replace|Mimic case}} option can be used to {{defined|mimic character case}} of matches upon replacing. This option individually converts {{defined|character case}} of the replacement string upon each match. The conversion is done upon actual replacing (i.e. after the replacement string is prepared for the match) and the conversion takes only {{defined|character case}} of the match into account. Therefore, the {{defined|mimic case}} may result in different {{defined|character case}} for each match. If the tool cannot decide how to {{defined|mimic case}} of a match, it leaves the replacement intact, giving the user a chance to specify one special {{defined|mixed case}} replacement.
@@ Line 25: / Line 25: @@
 Note: Search patterns are limited to 64 KiB. Prior to version 6.3, search patterns were limited to 8 KiB.

← Older revision		Revision as of 22:47, 5 October 2021
Line 23:		Line 23:

	Note: This tool is prefered to the standard {{button\|Replace\|Replace All}} mechanism from the {{feature\|Search and Replace}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature\|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature\|Undo}} step instead of too many small {{feature\|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button\|Replace\|Replace All}} routine might come more handy.		Note: This tool is prefered to the standard {{button\|Replace\|Replace All}} mechanism from the {{feature\|Search and Replace}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature\|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature\|Undo}} step instead of too many small {{feature\|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button\|Replace\|Replace All}} routine might come more handy.
		+
		+	Note: Search patterns are limited to 64 KiB. Prior to version 6.3, search patterns were limited to 8 KiB.

@@ Line 14: / Line 14: @@
 {{field|Extended Replace|Mimic case}} option can be used to {{defined|mimic character case}} of matches upon replacing. This option individually converts {{defined|character case}} of the replacement string upon each match. The conversion is done upon actual replacing (i.e. after the replacement string is prepared for the match) and the conversion takes only {{defined|character case}} of the match into account. Therefore, the {{defined|mimic case}} may result in different {{defined|character case}} for each match. If the tool cannot decide how to {{defined|mimic case}} of a match, it leaves the replacement intact, giving the user a chance to specify one special {{defined|mixed case}} replacement.
-{{tip}} The {{defined|mimic case}} option recognizes only ''basic'' types of {{defined|character case}}, i.e. {{defined|lower case}}, {{defined|upper case}}, {{defined|word capitals}}, {{defined|first capitals}}. Everyting else is considered {{defined|mixed case}} and the tool does not try to convert case of the replacement. This can be utilized to specify ''one'' {{defined|mixed case}} version of the replacement. Consider you need to replace {{string|OneHalf}} with {{string|SlovakBomber}}, but want to use the {{defined|mimic case}} to automatically replace {{string|onehalf}} with {{string|slovakbomber}} and {{string|ONEHALF}} with {{string|SLOVAKBOMBER}}. Using {{defined|mixed case}} {{string|SlovakBomber}} as a replacement will do the trick.
+{{tip}} The {{defined|mimic case}} option recognizes only ''basic'' types of {{defined|character case}}, i.e. {{defined|lower case}}, {{defined|upper case}}, {{defined|word capitals}}, {{defined|first capital}}. Everyting else is considered {{defined|mixed case}} and the tool does not try to convert case of the replacement. This can be utilized to specify ''one'' {{defined|mixed case}} version of the replacement. Consider you need to replace {{string|OneHalf}} with {{string|SlovakBomber}}, but want to use the {{defined|mimic case}} to automatically replace {{string|onehalf}} with {{string|slovakbomber}} and {{string|ONEHALF}} with {{string|SLOVAKBOMBER}}. Using {{defined|mixed case}} {{string|SlovakBomber}} as a replacement will do the trick.
 {{button|Extended Replace|Escape \}} button can be used to automatically escape all back-slashes in both {{field|Extended Replace|Find what}} and  {{field|Extended Replace|Replace with}} edit fields.

← Older revision		Revision as of 11:34, 19 November 2013
Line 22:		Line 22:
	Note: Newlines and Tab characters can be used in {{field\|Extended Replace\|Find what}} and {{field\|Extended Replace\|Replace with}} fields freely. Moreover, each newline from the {{field\|Extended Replace\|Find what}} field matches any kind of newline in the document (Win/Unix/Mac). Each newline from the {{field\|Extended Replace\|Replace with}} field is converted to the current newline type (as shown in the {{feature\|Status Bar}} for example) upon replacing.		Note: Newlines and Tab characters can be used in {{field\|Extended Replace\|Find what}} and {{field\|Extended Replace\|Replace with}} fields freely. Moreover, each newline from the {{field\|Extended Replace\|Find what}} field matches any kind of newline in the document (Win/Unix/Mac). Each newline from the {{field\|Extended Replace\|Replace with}} field is converted to the current newline type (as shown in the {{feature\|Status Bar}} for example) upon replacing.

−	Note: This tool is prefered to the standard {{button\|~~Find Bar~~\|Replace All}} mechanism from the {{feature\|~~Find Bar~~}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature\|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature\|Undo}} step instead of too many small {{feature\|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button\|~~Find Bar~~\|Replace All}} routine might come more handy.	+	Note: This tool is prefered to the standard {{button\|Replace\|Replace All}} mechanism from the {{feature\|Search and Replace}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature\|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature\|Undo}} step instead of too many small {{feature\|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button\|Replace\|Replace All}} routine might come more handy.

@@ Line 8: / Line 8: @@
 {{field|Extended Replace|Whole words}} option can be used to restrict the search to only those matches, which start and end at word boundaries. Note that a match itself might contain {{defined|non-word characters}}, since only the boundaries of the match are probed. Therefore, the last character before the match and the first character after the match may not be {{defined|word characters}}; while the first character and the last character of the match must be {{defined|word characters}}.
-{{field|Extended Replace|RegExps}} option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Extended Replace|Find what}} is parsed as a ''regular expression pattern''. See chapter [[Regular expressions]] for more details on supported regular expressions syntax.
+{{field|Extended Replace|RegExps}} option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Extended Replace|Find what}} is parsed as a ''regular expression pattern'' and {{field|Extended Replace|Replace with}} is parsed as a ''replace pattern''. See chapters [[Regular expressions]] and [[Regular expressions#Replace patterns|Replace patterns]] for more details on supported regular expressions syntax and replace pattern syntax.
 Note: Invalid or faulty patterns result in tool refusing to work until the pattern is corrected.

@@ Line 1: / Line 1: @@
-<noinclude>{{manversion|6.0.0.16|feature}}__NOTOC__</noinclude>
+<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
-====Extended Replace.. (Alt+Ctrl+R)====
+{{#headline:Text tools|Extended Replace.. (Alt+Ctrl+R)}}
 Searches for all occurrences of a specified {{field|Extended Replace|Find what}} phrase within the selection and replaces them with {{field|Extended Replace|Replace with}} phrase.

@@ Line 15: / Line 15: @@
 {{tip}} The {{defined|mimic case}} option only recognizes the ''basic'' types of {{defined|character case}}, i.e. {{defined|lower case}}, {{defined|upper case}}, {{defined|word capitals}}, {{defined|first capitals}}. Everyting else is considered {{defined|mixed case}} and the tool does not try to convert case of the replacement. This can be utilized to specify ''one'' {{defined|mixed case}} version of the replacement. Consider you need to replace {{string|OneHalf}} with {{string|SlovakBomber}}, but want to use the {{defined|mimic case}} to automatically replace {{string|onehalf}} with {{string|slovakbomber}} and {{string|ONEHALF}} with {{string|SLOVAKBOMBER}}. Using {{string|SlovakBomber}} as a replacement will do the trick.
 Note: Newlines and Tab characters can be used in {{field|Extended Replace|Find what}} and {{field|Extended Replace|Replace with}} fields freely. Moreover, each newline from the {{field|Extended Replace|Find what}} field matches any kind of newline in the document (Win/Unix/Mac). Each newline from the {{field|Extended Replace|Replace with}} field is converted to the current newline type (as shown in the {{feature|Status Bar}} for example) upon replacing.
 Note: This tool is prefered to the standard {{button|Find Bar|Replace All}} mechanism from the {{feature|Find Bar}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature|Undo}} step instead of too many small {{feature|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the <i>old good</i> looping {{button|Find Bar|Replace All}} routine might come more handy.