Find in Files (Tutorial)¶
To find a string in files, add the eighth line to our tutorial macro: Save the above macro and run it in a new EmEditor Window. Now "Em" is searched and
a message box with the text "Found!" is displayed.
The first argument of the Find Method specifies
a string to search for and the second argument specifies a flag to tell it how to search.
In this example, the second argument takes eeFindPrevious and searches backward from the current cursor position
to the top of the file.
The Find Method returns 1 if the search string is found. Otherwise, 0 is returned.
In this example, the search string is found and 1 is returned, so the Then clause,
that is alert Method, is executed.
The alert Method displays a simple message box with a OK button and the string of
the argument. In our tutorial, it displays the text "Found!".
The second argument of the Find Method
allows you to specify a variety of flags. See the argument explanations of the
Find Method for more details.
Normally, the execution of a macro is not terminated when the search string is not found. There is an exception, however.
If you execute a macro with theStop if Search Fails check box selected in theRun with Temporary Options command
under theMacro menu, the execution of the macro is terminated when the search string is not found.
ThisRun with Temporary Options lets you perform searches in flexible ways. For example, if you want to repeat
an operation, such as search and replace, and you don't know how many times the operation will occur,
you can have the search terminate upon the failure of the search, without modifying the macro,
by specifying the number of operations to repeat in greater numbers than you think you need.
If you want to terminate the execution of a macro upon the failure of the search
without using theRun with Temporary Options command, then you need to modify the macro.
That is, when the Find Method return 0, you terminate the macro.
The following code will do it: Also, if you use FindRepeat Method,
you can search again for the string that you have previously searched for, and you can search for the word
where the cursor is positioned on.
If you specify the flags of FindRepeat Method as follows,
it performs searches, which has the corresponding keyboard commands shortcuts. eeFindRepeatNext Search again forward from the current cursor position for the string that you have previously searched for. Equivalent to F3. eeFindRepeatPrevious Search again backward from the current cursor position for the string that you have previously searched for. Equivalent to Shift + F3. eeFindRepeatNext + eeFindRepeatWord Search forward from the current cursor position for the selected string or the word at the cursor. Equivalent to CTRL + F3. eeFindRepeatPrevious + eeFindRepeatWord Search backward from the current cursor position for the selected string or the word at the cursor. Equivalent to CTRL + SHIFT + F3.¶
[JavaScript]¶
document.selection.Text = "EmEditor supports macros.";
document.selection.NewLine();
document.selection.Text = "\tEmEditor is a text editor.";
document.selection.CharLeft( false, 12 );
document.selection.DeleteLeft( 15 );
document.selection.CharRight( true, 9 );
document.selection.ChangeCase( eeCaseUpperCase );
if( document.selection.Find( "Em", eeFindPrevious ) ) alert( "Found!");
[VBScript]¶
document.selection.Text = "EmEditor supports macros."
document.selection.NewLine
document.selection.Text = Chr(9) & "EmEditor is a text editor."
document.selection.CharLeft False, 12
document.selection.DeleteLeft 15
document.selection.CharRight True, 9
document.selection.ChangeCase eeCaseLowerCase
If document.selection.Find( "Em", eeFindPrevious ) Then alert "Found!"
[JavaScript]¶
if( !document.selection.Find( "xx", eeFindPrevious ) ) throw new
Error("Cannot find xx");
[VBScript]¶
If Not document.selection.Find( "xx", eeFindPrevious ) Then Err.Raise
vbObjectError + 1, "Find Error", "Cannot find xx"