Find and Replace - Revision history

Fal7i at 14:58, 16 June 2011

2011-06-16T14:58:11Z

← Older revision		Revision as of 14:58, 16 June 2011
Line 11:		Line 11:
	{{toc}}		{{toc}}

	The Edit menu features several options for Find and Replace. The <tt>Edit → Find...</tt>('''Ctrl+F''') and <tt>Edit → Replace...</tt> ('''Ctrl+H''') menu items will simply start their corresponding dialogs described in [ch05s10\|Section 10, “Basic Find and Replace”].		The Edit menu features several options for Find and Replace. The <tt>Edit → Find...</tt> ('''Ctrl+F''') and <tt>Edit → Replace...</tt> ('''Ctrl+H''') menu items will simply start their corresponding dialogs described in [ch05s10\|Section 10, “Basic Find and Replace”].

	== 5.1. Find Again ==		== 5.1. Find Again ==
Line 24:		Line 24:
	== 5.2. Find from Selection ==		== 5.2. Find from Selection ==
	The <tt>Edit → Find from selection</tt> menu item will search for the currently selected text. If you select for example the name of a function, in bluefish, or in any other program, and you choose find from selection Bluefish will start a new search for this selected string.		The <tt>Edit → Find from selection</tt> menu item will search for the currently selected text. If you select for example the name of a function, in bluefish, or in any other program, and you choose find from selection Bluefish will start a new search for this selected string.
			{{tip\|text=Bluefish 2.04: <tt>Edit → Find from clipboard</tt> ('''Maj+Ctrl+F''')}}

	Here we have selected a function in a C file:		Here we have selected a function in a C file:

John Bryan: Corrected group capture itteration and examples, modified inaccurate OS specific \n \r comment, modified examples to not be specific to \n (hex 0A) line feed characters

2011-06-15T19:06:40Z

Corrected group capture itteration and examples, modified inaccurate OS specific \n \r comment, modified examples to not be specific to \n (hex 0A) line feed characters

← Older revision		Revision as of 19:06, 15 June 2011
Line 39:		Line 39:

	<div style="float:left">		<div style="float:left">
	{{tip\|text='''~~You can't use ^~~'''. To find a ~~'''A''' at the beginning of~~ a ~~line~~ use <tt>\nA</tt> ~~in unix~~ or ~~windows documents,~~ <tt>\rA</tt> ~~in Mac~~.<br />		{{tip\|text='''Detecting newline characters:'''. What character is used by default to mark new lines in documents can vary not only according to the operating system being used but also according to which application created them. You may find that it is a <tt>\n</tt> (hex 0A), a <tt>\r</tt> (hex 0D) or even both <tt>\n\r</tt>. <br />
	'''~~You can't use~~ $'''. To find a '''A''' at the ~~end~~ of a line use <tt>A\n</tt> ~~in unixdocuments,~~ <tt>A\r</tt> ~~in Mac or windows~~.}}		Therefore, if there is any doubt, you may need to use <tt>[\n\r]</tt> or similar. If using the Perl style RegEx you can instead use <tt>\R</tt>.}}
			</div>
			{{clear}}
			<div style="float:left">
			{{tip\|text='''RegEx anchors <tt>^</tt> & <tt>$</tt> match the start and the end of the whole document respectively'''.<br />
			To find a '''A''' at the begining of a line within the document use <tt>[\n\r]A</tt>.<br />
			To find a '''A''' at the end of a line use <tt>A[\n\r]</tt>.}}
	</div>		</div>
	{{clear}}		{{clear}}
Line 174:		Line 180:
	Next, this sequence is embedded into <tt><nowiki><td></nowiki></tt> and <tt><nowiki></td></nowiki></tt>, which is expressed simply concatenating the strings: <tt><nowiki><td>([^<]+)</td></nowiki></tt>		Next, this sequence is embedded into <tt><nowiki><td></nowiki></tt> and <tt><nowiki></td></nowiki></tt>, which is expressed simply concatenating the strings: <tt><nowiki><td>([^<]+)</td></nowiki></tt>

	We should also add the end of line character, which ~~is expressed~~ as: <tt>\n</tt>. The regular expression now describes a whole line: <tt><nowiki><td>([^<]+)</td>\n</nowiki></tt>		We should also add the end of line character, which we will express as: <tt>[\n\r]</tt>. The regular expression now describes a whole line: <tt><nowiki><td>([^<]+)</td>[\n\r]</nowiki></tt>

	As we cannot use variables to retrieve the headers of the table, we will merely repeat that string five times, so that the regular expression matches exactly the six lines of importance to us.		As we cannot use variables to retrieve the headers of the table, we will merely repeat that string five times, so that the regular expression matches exactly the six lines of importance to us.
Line 182:		Line 188:
	The regular expression becomes (backslashes are inserted at end of line just for the purpose of not to have too long lines):		The regular expression becomes (backslashes are inserted at end of line just for the purpose of not to have too long lines):

	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>

	Those lines are at their turn embedded into <tt><nowiki><tr></nowiki></tt> and <tt><nowiki></tr></nowiki></tt> tags each of them on their own line, which can be expressed as: <tt><nowiki><tr>\n</nowiki></tt> for the first one, and <tt><nowiki></tr>\n</nowiki></tt> for the second one. We add those strings respectively at the beginning and at the end of our regular expression, which becomes:		Those lines are at their turn embedded into <tt><nowiki><tr></nowiki></tt> and <tt><nowiki></tr></nowiki></tt> tags each of them on their own line, which can be expressed as: <tt><nowiki><tr>\n</nowiki></tt> for the first one, and <tt><nowiki></tr>\n</nowiki></tt> for the second one. We add those strings respectively at the beginning and at the end of our regular expression, which becomes:

	<nowiki><tr>\n \</nowiki>		<nowiki><tr>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki><td>([^<]+)</td>\n \</nowiki>		<nowiki><td>([^<]+)</td>[\n\r]</nowiki>
	<nowiki></tr>\n</nowiki>		<nowiki></tr>[\n\r]</nowiki>

	Now that we have described the search pattern, we will build the replace pattern. Each expression embedded into parentheses in the search string can be retrieved with <tt>\x</tt>, where x is an integer starting at 0 for the first expression, 1 for the second, etc. All others parts in the final string are fixed strings which we will express as they are.		Now that we have described the search pattern, we will build the replace pattern. Each expression embedded into parentheses in the search string can be retrieved with <tt>\x</tt>, where x is an integer starting at 1 for the first expression, 2 for the second, etc. All others parts in the final string are fixed strings which we will express as they are. When x is zero (i.e. <tt>\0</tt>) the whole of the matched area of the string is returned, in this case from the <tr> to the </tr>.

	The first line becomes (note the \n at the end to match the end of line character):		The first line becomes (note the [\n\r] at the end to match the end of line character):

	<nowiki><p class="st2">\0</p>\n</nowiki>		<nowiki><p class="st2">\1</p>[\n\r]</nowiki>

	The second line (again, note the \n to match the end of line characters):		The second line (again, note the [\n\r] to match the end of line characters):

	<nowiki><dl>\n<dt>Use:</dt><dd><span class="dd1">\1</dd>\n</nowiki>		<nowiki><dl>[\n\r]<dt>Use:</dt><dd><span class="dd1">\1</dd>[\n\r]</nowiki>

	And finally the whole replace pattern is:		And finally the whole replace pattern is:

	<nowiki><p class="st2">\0</p>\n \</nowiki>		<nowiki><p class="st2">\1</p>[\n\r]</nowiki>
	<nowiki><dl>\n<dt>Use:</dt><dd><span class="dd1">\1</dd>\n \</nowiki>		<nowiki><dl>\n<dt>Use:</dt><dd><span class="dd1">\2</dd>[\n\r]</nowiki>
	<nowiki><dt>System requirements:</dt><dd><span class="dd1">\2</span></dd>\n \</nowiki>		<nowiki><dt>System requirements:</dt><dd><span class="dd1">\3</span></dd>[\n\r]</nowiki>
	<nowiki><dt>Author:</dt><dd><span class="dd1">\3</span></dd>\n \</nowiki>		<nowiki><dt>Author:</dt><dd><span class="dd1">\4</span></dd>[\n\r]</nowiki>
	<nowiki><dt>Date:</dt><dd><span class="dd1">\4</dd>\n \</nowiki>		<nowiki><dt>Date:</dt><dd><span class="dd1">\5</dd>[\n\r]</nowiki>
	<nowiki><dt>Download:</dt><dd><span class="dd1">\5</span></dd>\n</dl>\n</nowiki>		<nowiki><dt>Download:</dt><dd><span class="dd1">\6</span></dd>[\n\r]</dl>[\n\r]</nowiki>

	After entering both patterns, choose PERL type in the Regular expression drop down list, check the Patterns contain backslash escape sequences (\n, \t) and click OK.		After entering both patterns, choose PERL type in the Regular expression drop down list, check the Patterns contain backslash escape sequences (\n, \t) and click OK.

Fal7i: /* 5.3. Find and Replace Using Regular Expressions */

2011-01-24T10:26:23Z

5.3. Find and Replace Using Regular Expressions

← Older revision		Revision as of 10:26, 24 January 2011
Line 48:		Line 48:

	PERL: you can use \R to discover end of line and it will match \n, \r or \n\r.<br/>		PERL: you can use \R to discover end of line and it will match \n, \r or \n\r.<br/>
	POSIX: \R match r, \N n, \P p etc.		POSIX: \R match r, \N n, \P p etc.<br/>
			unfortunately <tt>[^\R]</tt> match r with PERL and POSIX.


	{{note\|text=To enable the escaped characters in your searches or replaces check the <tt>Pattern contains backslash escaped characters such as \n \t etc.</tt> option.<br/> In this case you have to write: \\d \\D \\w \\W \\s \\S}}		{{note\|text=To enable the escaped characters in your searches or replaces check the <tt>Pattern contains backslash escaped characters such as \n \t etc.</tt> option.<br/> In this case you have to write: \\d \\D \\w \\W \\s \\S}}

Fal7i: /* 5.3. Find and Replace Using Regular Expressions */

2011-01-24T09:33:45Z

5.3. Find and Replace Using Regular Expressions

← Older revision		Revision as of 09:33, 24 January 2011
Line 50:		Line 50:
	POSIX: \R match r, \N n, \P p etc.		POSIX: \R match r, \N n, \P p etc.

			{{note\|text=To enable the escaped characters in your searches or replaces check the <tt>Pattern contains backslash escaped characters such as \n \t etc.</tt> option.<br/> In this case you have to write: \\d \\D \\w \\W \\s \\S}}

	~~{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}~~
	'''Example VI.1. Retrieving all sections in an xml book'''		'''Example VI.1. Retrieving all sections in an xml book'''

Fal7i: /* 5.3. Find and Replace Using Regular Expressions */

2011-01-24T09:20:31Z

5.3. Find and Replace Using Regular Expressions

← Older revision		Revision as of 09:20, 24 January 2011
Line 37:		Line 37:
	== 5.3. Find and Replace Using Regular Expressions ==		== 5.3. Find and Replace Using Regular Expressions ==
	With find and replace you can do incredibly powerful searches. We have already seen some of them in [ch06s04#\|generate-bookmark Section 4.1, “Generating several bookmarks at once”], which deserve some explanation here.		With find and replace you can do incredibly powerful searches. We have already seen some of them in [ch06s04#\|generate-bookmark Section 4.1, “Generating several bookmarks at once”], which deserve some explanation here.

	<div style="float:left">		<div style="float:left">
	~~{{warning\|text=You can't use '''\d''' use <tt>[0-9]</tt> instead.<br/>~~		{{tip\|text='''You can't use ^'''. To find a '''A''' at the beginning of a line use <tt>\nA</tt> in unix or windows documents, <tt>\rA</tt> in Mac.<br />
	~~You can't use '''\D''' use <tt>[^0-9]</tt> instead.<br/>~~		'''You can't use $'''. To find a '''A''' at the end of a line use <tt>A\n</tt> in unixdocuments, <tt>A\r</tt> in Mac or windows.}}
	~~You can't use '''\w''' use <tt>[a-zA-Z0-9_]</tt> instead.<br/>~~
	~~You can't use '''\W''' use <tt>[^a-zA-Z0-9_]</tt> instead.<br/>~~
	~~You can't use '''\s''' use <tt>[\t\n\r]</tt> instead.<br/>~~
	~~You can't use '''\S''' use <tt>[^\t\n\r]</tt> instead.<br/>~~
	~~You can't use '''^''' and '''$'''. <tt></tt><br/>}}~~
	~~</div>~~
	~~<div style="float:left">~~
	{{tip\|text='''You can't use ^'''. To find a '''A''' at the beginning ~~<br />~~of a line use <tt>\nA</tt> in unix or windows documents, <tt>\rA</tt> in Mac.<br />
	'''You can't use $'''. To find a '''A''' at the end ~~<br />~~of a line use <tt>A\n</tt> in unixdocuments, <tt>A\r</tt> in Mac or windows.}}
	</div>		</div>
	{{clear}}		{{clear}}

	~~check the Patterns contain backslash escape sequences,<br/>~~		PERL: \d \D \w \W \s \S work.<br/>
	PERL: \\d \\D \\w \\W \\s \\S work.		POSIX: only \w \W \s \S work.
	POSIX: only \\w \\W \\s \\S work.
			PERL: you can use \R to discover end of line and it will match \n, \r or \n\r.<br/>
			POSIX: \R match r, \N n, \P p etc.


	{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}		{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}

Fal7i: /* 5.3. Find and Replace Using Regular Expressions */

2011-01-24T08:58:57Z

5.3. Find and Replace Using Regular Expressions

← Older revision		Revision as of 08:58, 24 January 2011
Line 51:		Line 51:
	</div>		</div>
	{{clear}}		{{clear}}

			check the Patterns contain backslash escape sequences,<br/>
			PERL: \\d \\D \\w \\W \\s \\S work.
			POSIX: only \\w \\W \\s \\S work.

	{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}		{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}
	'''Example VI.1. Retrieving all sections in an xml book'''		'''Example VI.1. Retrieving all sections in an xml book'''

Fal7i at 11:09, 23 January 2011

2011-01-23T11:09:14Z

← Older revision		Revision as of 11:09, 23 January 2011
Line 47:		Line 47:
	</div>		</div>
	<div style="float:left">		<div style="float:left">
	{{~~note~~\|text='''You can't use ^'''. To find a '''A''' at the beginning <br />of a line use <tt>\nA</tt> in unix or windows documents, <tt>\rA</tt> in Mac.<br />		{{tip\|text='''You can't use ^'''. To find a '''A''' at the beginning <br />of a line use <tt>\nA</tt> in unix or windows documents, <tt>\rA</tt> in Mac.<br />
	'''You can't use $'''. To find a '''A''' at the end <br />of a line use <tt>A\n</tt> in unixdocuments, <tt>A\r</tt> in Mac or windows.}}		'''You can't use $'''. To find a '''A''' at the end <br />of a line use <tt>A\n</tt> in unixdocuments, <tt>A\r</tt> in Mac or windows.}}
	</div>		</div>
	{{clear}}		{{clear}}
			{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}
	'''Example VI.1. Retrieving all sections in an xml book'''		'''Example VI.1. Retrieving all sections in an xml book'''

Line 224:		Line 225:
	In the Find and Replace dialogs it is not possible to insert the keys '''Enter''' or '''Tab'''. A simple way to do it is to copy two lines in a row from the current document into the Find or Replace dialog, this way you retrieve the end of line character. The same applies for '''Tab'''. A more elaborated way to do it is to use escaped characters to represent these characters. A new line character, produced by pressing the '''Enter''' key, is represented as <tt>\n</tt>. Use <tt>\t</tt> for a tab. To get an actual backslash, just escape the backslash, <tt>\\</tt>. There are many other escape characters used in regular expressions.		In the Find and Replace dialogs it is not possible to insert the keys '''Enter''' or '''Tab'''. A simple way to do it is to copy two lines in a row from the current document into the Find or Replace dialog, this way you retrieve the end of line character. The same applies for '''Tab'''. A more elaborated way to do it is to use escaped characters to represent these characters. A new line character, produced by pressing the '''Enter''' key, is represented as <tt>\n</tt>. Use <tt>\t</tt> for a tab. To get an actual backslash, just escape the backslash, <tt>\\</tt>. There are many other escape characters used in regular expressions.

	{{note\|text=To enable the escaped characters in your searches check the Patterns contain backslash sequences (\n, \t) option.}}		{{note\|text=To enable the escaped characters in your searches or replaces check the Patterns contain backslash sequences (\n, \r, \t) option.}}

	If you have any search and replace patterns you use often, you can also add them to the Custom Menu. Check [[Man 2 ch07s07\|Section 7, “Custom menu”]] for more information.		If you have any search and replace patterns you use often, you can also add them to the Custom Menu. Check [[Man 2 ch07s07\|Section 7, “Custom menu”]] for more information.

Fal7i: /* 5.3. Find and Replace Using Regular Expressions */

2011-01-23T11:05:47Z

5.3. Find and Replace Using Regular Expressions

@@ Line 37: / Line 37: @@
 == 5.3. Find and Replace Using Regular Expressions ==
 With find and replace you can do incredibly powerful searches. We have already seen some of them in [ch06s04#|generate-bookmark Section 4.1, “Generating several bookmarks at once”], which deserve some explanation here.
+<div style="float:left">
 '''Example&nbsp;VI.1.&nbsp;Retrieving all sections in an xml book'''

Bill Valaski: moved Man 2 ch06s05 to Find and Replace: Title updated (BV)

2010-07-01T01:25:12Z

moved Man 2 ch06s05 to Find and Replace: Title updated (BV)

← Older revision	Revision as of 01:25, 1 July 2010
(No difference)

Fal7i: add Templates

2010-03-07T11:03:36Z

add Templates

← Older revision		Revision as of 11:03, 7 March 2010
Line 6:		Line 6:
	\|prev=Man 2 ch06s04		\|prev=Man 2 ch06s04
	\|Subtitle=Chapter VI. Navigation and Managing documents		\|Subtitle=Chapter VI. Navigation and Managing documents
	\|next=~~Man 2 ch07~~		\|next=Templates
	}}		}}

Line 221:		Line 221:
	\|prev=Man 2 ch06s04		\|prev=Man 2 ch06s04
	\|up=Man 2 ch06		\|up=Man 2 ch06
	\|next=~~Man 2 ch07~~		\|next=Templates
	\|prevname= 4. Bookmarks		\|prevname= 4. Bookmarks
	\|nextname=~~Chapter VII. More than a Text Editor~~		\|nextname=Templates
	}}		}}